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This chapter describes the differences between BASIC 2.0/2.1 extensions and 
BASIC 3.0. 

Note 

If you are porting a program from a “pre-3.0” version of the 
BASIC system to a 4.0 or 5.0 system, then you should also 
read the subsequent porting chapters. Anytime you see 3.0 
mentioned in this chapter it also refers to all subsequent system 
versions. 




Porting Topics Covered 


The following areas require consideration when transporting programs from 
BASIC 2.0/2.1 to BASIC 3.0. They are listed in the order in which they’re 
discussed in this chapter. 

■ Compatibility with previous versions 

■ Configuring BASIC 

■ Statement changes 

■ CSUBs 

■ PHYREC 

■ Knob 

■ Graphics 

□ Default plotter 

d Implicit GCLEAR 

□ Input device viewport 

□ Graphics Tablet DIGITIZE 

□ The VIEWPORT Statement 

□ The PIVOT Statement 
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■ Display functions 

■ Prerun on LOADSUB 

■ Special case of I/O transfers 


Compatibility with Preceding Versions 

If you have programs which were written on previous Series 200 BASIC 
systems, you can use these same programs with little or no changes. The 
major task you have to perform is to configure the BASIC 3.0 system with the 
necessary BIN files. 


Configuring BASIC 

This section contains procedures that help you ensure you have loaded all the 
required language extensions and drivers. It also tells you where to find related 
information in your BASIC manual set. 

Helpful Documentation 

The BASIC manuals can help you determine which BIN files you need. The 
chapter titled “Language, Extensions, Drivers and Configuration” of Installing 
and Maintaining Your BASIC System contains a brief description of each BIN 
file. It also lists the functions and statements supported by each Language 
Extensions BIN file. 

The BASIC Language Reference manual contains an alphabetical list of all 
keywords showing which BIN file, if any, is needed for each keyword. Keep 
in mind that some keywords are partially supported by just core BASIC 
(SYSTEM_BAn) and that additional capabilities may require a BIN file. For 
example, CAT is supported by core BASIC, but the MS BIN file is needed to 
support SELECT and other advanced features. 
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Missing Language Extensions BIN Files 

Follow this procedure to make sure that you have all the language extensions 
BIN files that a program needs. The procedure ensures that each program unit 
is not prerun and then preruns all program units. Prerun reports the first 
missing BIN file that it finds. Editing a program unit ensures that it is not in 
the prerun state. Stepping a stopped program preruns it. 

Load the program and the BIN files PDEV and ERR. Enter the first line of the 
program to ensure that the main program is not in a prerun state. Find every 
SUB statement (using the FIND command enabled by the PDEV BIN file) 
and enter it. Find every DEF FN statement and enter it. Now no program 
unit is in a prerun state. Stepping preruns every subprogram. If prerun finds a 
statement or option that requires a missing BIN file, error 1 is given along with 
the name (if the ERR BIN file is loaded) of the missing BIN file. After loading 
the missing BIN file, step again to prerun the program. If a BIN file is missing, 
error 1 and its name are given. Repeat this process until stepping gives no 
errors. At that point, all language extensions BIN files needed by the program 
are present. If the program loads subprograms or other programs, repeat this 
process for each of them. 

This process does not work for a secured program. The best approach in this 
case is to ask the author or vendor for a list of the BIN files required. If this 
is not possible, load the ERR BIN file and run the program. Whenever a 
statement is executed that requires a missing BIN file, an error 1 and the 
name of the BIN file are given. After loading the BIN file, the program can be 
continued. However, it may be difficult to force the execution of all paths in 
the program. This can be a serious problem if a real-time control program is 
surprised by a missing BIN file at a critical moment. 

Remember, if you have enough memory, you can load all the BIN files. 

However, only load KNB2.0 if you want KNOBX to function as it does in 
BASIC 2.0/2.1 and KNOBY to always return a zero. Refer to the Knob section 
later in this chapter for more information. 
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Missing Driver BIN Files 

To ensure that all required driver BIN files are loaded, load the appropriate 
BIN file for each interface card and I/O port used (including the built-in HP-IB 
and RS-232 serial interface, if present). Also load the appropriate disc driver 
BIN file for each disc drive used. 

If an operation is attempted to a device but the card driver BIN file is 
missing, the message “ERROR 163 I/O interface/driver not present” is usually 
provided. Examples of this are: CAT“:,700” or PRINTER IS 701 with the 
HPIB BIN file missing. 

If the card BIN file is present but the disc driver BIN file is missing, an 
attempt to access the disc causes error 1. If the ERR BIN file is loaded, the 
message “ERROR 1 Configuration error” is provided. 

If both the card driver and disc driver BIN files are missing, error 163 is 
usually given but error 1 can also occur. 


Statement Changes 

There are several statements added with BASIC 3.0. These are listed below. 


KNOBY 

LIST BIN 

MAXREAL 

MINREAL 

MODULO 

PDIR 

PLOTTER IS file 
PRINT LABEL 


PRINTER IS file 
READ LABEL 
RES 

SCRATCH BIN 
SECURE 
SET LOCATOR 
STORE SYSTEM 
SYSBOOT 


Two statements were deleted, STORE BIN and RE-STORE BIN. 
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CSUBs 


If you used Pascal-compiled subprograms (CSUBs) in your BASIC 2.0/2.1 
programs, you need to purchase a Pascal 3.0 system upgrade and a CSUB 
Utility upgrade to use those CSUBs with BASIC 3.0. You must recompile 
the Pascal routine on Pascal 3.0 and re-execute the CSUB utility to make the 
routine look like a BASIC subprogram. If you are using a CSUB supplied by a 
vendor, you must have the supplier update the CSUB for you. 


PHYREC 

The PHYREC routine that allowed you to read from and write to physical 
records on a disc was changed from a binary program to a CSUB with BASIC 
3.0. The PHYREC CSUB is located on the BASIC Utilities Disc. 

You must append the PHYREC CSUB to your program and change the 
PHYREAD/PHYWRITE statements. If the PHYREC binary is appended to a 
program, a warning message is displayed and the binary is ignored by BASIC. 

Use the following steps to locate all the lines for an application that uses 
PHYREC and change them to call and append the PHYREC CSUB. 

1. Boot a BASIC 2.0/2.1 system. 

2. Delete the PHYREC binary. 

LOAD "program" 

SAVE "program2" 

SCRATCH A 
GET "program2" 

RE-STORE "program" 

PURGE "program2" 

3. Attach the PHYREC CSUB. 

LOADSUB ALL FROM "PHYREC" 


This saves the program without the binary. 

This deletes the program and binary from memory. 

Calls to PHYREC are commented. Write down the line 
numbers. 


This file is located on BASIC Utilities Disc . Do not try to run your 
application until you have completed all steps. 
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4. Uncomment and change all the calls to PHYREC. These are the lines you 
noted in step 2 above. 

PHYREAD Sector,Int_array(*) > Phyread(Sector,Int.array(*)) 

PHYWRITE Sector,Int.array(*) > Phywrite(Sector,Int.array(*)) 

5. If Sector is declared to be an INTEGER, you need to put it into 
parentheses so that PHYREC will interpret is as a REAL. 

Phyread((Sector),Int_array(*)) 

6. The syntax for a conditional call must be changed from: 

IF condition THEN PHYREAD Sector,Int.array(*) 
to: 

IF condition THEN 

Phyread(Sector,Int.array(*)) 

END IF 

or to: 

IF condition THEN CALL Phyread(Sector,Int.array(*)) 

7. RE-STORE "program" after you have completed the changes. 

8. Boot BASIC 3.0 and run your application. 


Knob 

In BASIC 3.0, unshifted knob movement causes horizontal cursor movement, 
and shifted knob movement results in vertical movement. This allows for 
greater compatibility between the knob and the HP-HIL mouse. (In BASIC 
2.0/2.1, horizontal and vertical modes are toggled and interlocked.) 

The KNOBX Function 

The BASIC 2.0/2.1 definition of KNOBX, which we will refer to as all-pulse 
mode, is as follows: When an ON KNOB statement is executed to trap 
knob movement, knob pulses are accumulated and accessed via the KNOBX 
statement. Since the KNOBX function returns information on X-axis 
movement, a method of tracking Y-axis movement is not directly available 


18-6 Porting to 3.0 





with BASIC 2.0/2.1. The common method used to track Y-axis movement, 
is to interrogate keyboard status register 10 for information on the state of 
the CTRL and SHIFT keys at the time of the last knob interrupt. Using this 
information, SHIFTed and/or CTRLed knob movement could be interpreted 
differently; in fact, an example program showing this was included in the 
2.0/2.1 manual set. Following is another sample 2.0/2.1 program with this type 
of knob interpretation: 


30 

ON KNOB .1 G0SUB Knobsvc 


40 

Loop: GOTO Loop 


50 

STOP 


60 ! 



70 

Knobsvc: ! 


80 

STATUS KBD,10;State 

! was SHIFT or CTRL key pressed? 

90 

Shift=BIT(State,0) 

! bit 0 set = SHIFT key pressed 

100 

Ctrl=BIT(State,1) 

! bit 1 set * CTRL key pressed 

110 

SELECT Shift 


120 

CASE 0 

! if shift not pressed, X direction 

130 

IF Ctrl THEN 

! if Ctrl pressed, give finer resolution 

140 

X=X+KN0BX/10 


150 

ELSE 


160 

X=X+KN0BX 


170 

ENDIF 


180 

CASE 1 

* if shift pressed, Y direction 

190 

IF Ctrl THEN 

! if Ctrl pressed, give finer resolution 

200 

Y=Y+KNQBX/10 


210 

ELSE 


220 

Y=Y+KN0BX 


230 

ENDIF 


240 

END SELECT 



With the introduction of the new HP-HIL keyboards (no built-in knob but 
optional mouse), the intent was to allow the mouse to emulate knob behavior 
in situations where a knob is no longer present. The all-pulse mode of 
interpretation, however, is unacceptable when using a mouse because the mouse 
is not a unidirectional device, yet movement information in only one direction 
is available. It is virtually impossible to move the mouse in one direction only. 
To be able to distinguish movement in each direction, the keyword KNOBY 
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has been added to BASIC 3.0. KNOBY returns the net number of Y-direction 
knob pulses counted since the last time the KNOBY counter was zeroed. 

Keyboards with Built-in Knob 

To convert your programs which run on hardware with a built-in knob from 
2.0/2.1 to 3.0, simply replace KNOBX with KNOBX+KNOBY in situations 
where total knob movement is being recorded. The major difference in 3.0 
operation is that knob pulses in the X-direction are accessed via KNOBX and 
knob pulses in the Y-direction are accessed via KNOBY. One way to modify 
the above program for 3.0 is: 


30 

ON KNOB .1 G0SUB Knobsvc 


40 

Loop: GOTO Loop 


50 

STOP 


60 ! 



70 

Knobsvc: ! 


80 

STATUS KBD,10;State 

! was SHIFT or CTRL key pressed? 

90 

Shift=BIT(State,0) 

! bit 0 set = SHIFT key pressed 

100 

Ctrl=BIT(State,1) 

! bit 1 set = CTRL key pressed 

110 

SELECT Shift 


120 

CASE 0 

! if shift not pressed, X direction 

130 

IF Ctrl THEN 

! if Ctrl pressed, give finer resolution 

140 

X=X+KN0BX/10 


150 

ELSE 


160 

X=X+KN0BX 


170 

ENDIF 


180 

CASE 1 

! if shift pressed, Y direction 

190 

IF Ctrl THEN 

! if Ctrl pressed, give finer resolution 

200 

Y=Y+KN0BY/10 


210 

ELSE 


220 

Y=Y+KN0BY 


230 

ENDIF 


240 

END SELECT 
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However, this does not work with the HP-HIL mouse. A method that works 
with the HP-HIL mouse as well as with the built-in knob is: 


30 ON KNOB .1 GOSUB Knobsvc 

40 Loop: GOTO Loop 

50 STOP 

60 ! 

70 Knobsvc: ! 

80 X=X+KN0BX 

90 Y=Y+KN0BY 


HP-HIL Keyboards with Mouse 

If your ON KNOB routine reads keyboard status register 10 for shift-knob or 
control-knob actions you will need to make some other changes to convert 
2.0/2.1 programs to 3.0. On HP-HIL input devices (i.e. the mouse), keyboard 
status register 10 has a different interpretation: bit 0 (SHIFT key pressed) is 
set if last data processed at the last knob interrupt was Y-axis information 
(data accessed via KNOBY) and cleared if last data processed was X-axis 
data; bit 1 (CTRL key pressed) is never set. If unidirectional HP-HIL devices 
were to become available, a toggle switch would exist on the device to switch 
between X-axis and Y-axis directions and the shift bit on keyboard status 
register 10 would be set when in the Y-direction mode. 

The previous program segment shows recommended servicing of the mouse. 

Programming for Both Versions and Keyboards 

In the most complicated case, you may wish to write code that runs on both 
BASIC 2.0/2.1 and BASIC 3.0 with either a built-in knob or HP-HIL mouse. 
Write knob service routines for the BASIC 2.0/2.1 program and the BASIC 3.0 
program and LOADSUB the appropriate routine based on the current version 
of BASIC. The following program segments show one method of handling this 
situation: 
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30 GQSUB Whichversion 

40 IF Version=3 THEN 

50 LOADSUB ALL FROM "KN0BSVC3_0 H 

60 ELSE 

70 LOADSUB ALL FROM M KN0BSVC2_0" 

80 END IF 


110 Whichversion: ! running BASIC 2.0/2.1 or 3.0 ? 

120 ON ERROR GOTO B2_0 

130 STATUS 2,2;A ! KBD register 2 does not exist for 2.0/2.1, error 

140 Version=3 ! if line 130 didn’t error out, must be 3.0 

150 GOTO Versionfound 

160 B2_0: ! 

170 Version=2 

180 Versionfound: ! 

190 OFF ERROR 

200 RETURN 


KNB2.0 

Because these modifications to the KNOB facilities may prevent your 2.0/2.1 
programs from running on BASIC 3.0 without making a few changes, we have 
developed a way to return to the all-pulse mode of KNOB operation in which 
all knob pulses are accessed via KNOBX. This mode is not recommended for 
the HP-HIL mouse. To switch to this mode, execute CONTROL KBD,11;1. 


Note if you select all-pulse mode, KNOBY always returns a zero. 


Executing CONTROL KBD,11;0 returns you to the 3.0 mode of operation in 
which Y-direction pulses are accessed via KNOBY. To determine the mode, 
execute STATUS KBD,11;M. If M=0, KNOBX is in horizontal-pulse mode; if 
M=l, KNOBX is in all-pulse mode. 

In some cases, it may be desirable to make this mode change implicitly. This 
can be accomplished by loading the BIN file KNB2.0 from the Language 
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Extensions disk. A LIST BIN describes the new BIN file as 2.0 KNOBX 
Definition. The only effect of KNB2.0 being loaded is that it executes 
CONTROL KBD,11;1 for you automatically. When KNB2.0 is loaded, 
executing SCRATCH A also automatically executes CONTROL KBD,11;1. 
Note that if this binary is included in a stored system (e.g. created with the 
STORE SYSTEM statement), the effects are the same as loading it afterwards. 


Note All-pulse mode (KNB2.0 loaded) is not recommended for the 

HP-HIL mouse. Also note that the KNB2.0 binary and the 
all-pulse mode are not supported by BASIC/UX. 


Special Consideration 

Since the KNB2.0 binary functionality is not supported by BASIC/UX, you 
will need to modify any program containing this functionality. 


Graphics 

Several graphics statements function differently with BASIC 3.0 than they did 
in BASIC 2.0/2.1. This section explains the differences. 

Default Plotter 

The initialization of graphics system variables and devices was changed 
slightly in BASIC 3.0. When GINIT is executed, several operations are 
performed automatically such as setting line type and character size. In 
addition to these operations, BASIC 2.0/2.1 also implicitly does a PLOTTER 
IS 3,“INTERNAL” to select the CRT as the default plotting device. In BASIC 
3.0, the default plotting device is not selected until a statement is executed 
that affects it (e.g., DRAW, LABEL, GLOAD). At this time, the appropriate 
PLOTTER IS statement is executed along with GCLEAR, VIEWPORT and 
WINDOW statements. Refer to GINIT in the BASIC Language Reference 
manual for more information. 
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Implicit GCLEAR 

In BASIC 2.0/2.1, any graphics statement following GINIT except PLOTTER 
IS, GINIT, and DUMP DEVICE causes the implicit execution of GCLEAR, 
VIEWPORT, and WINDOW. With BASIC 3.0, if a statement that requires 
a plotter is executed after GINIT, a PLOTTER IS CRT,“INTERNAL” is 
executed followed by GCLEAR, VIEWPORT, and WINDOW. Refer to GINIT 
in the BASIC Language Reference manual for more information. 

Input Device Viewport 

The GRAPHICS INPUT IS statement sets the hard clip limits of the input 
device to the largest space possible that has the same aspect ratio as the 
output device. Since this was not so in earlier versions, there were two 
potential problems. The first problem is that it is possible to move to positions 
on the input device that do not exist on the output device. The extent of this 
problem may be reduced with BASIC 3.0, but the problem is not eliminated. 
The second problem is that the aspect ratios of the input and output devices 
may differ causing pictures on the devices to appear different. BASIC 3.0 
solves this problem by automatically setting the hard clip limits of the input 
device to the largest possible space that has the same aspect ratio as the 
output device. 

Graphics Tablet DIGITIZE 

A stylus press on the HP 9111A Graphics Tablet prior to execution of a 
DIGITIZE statement does not satisfy the DIGITIZE with BASIC 3.0 as it does 
with BASIC 2.0/2.1. An output of the string “SG” to the graphics tablet after 
the GRAPHICS INPUT IS statement causes BASIC 3.0 to work like BASIC 
2 . 0 / 2 . 1 . 

The VIEWPORT Statement 

VIEWPORT was changed in BASIC 3.0 to make it compatible with the 
Series 500 and the industry standard. In BASIC 3.0, VIEWPORT rescales 
immediately. In BASIC 2.0/2.1, VIEWPORT does not rescale; only WINDOW 
and SHOW statements rescale. 
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An example helps demonstrate the difference. The following program 
behaves the same way in BASIC 2.0/2.1 and 3.0 because it does not have a 
VIEWPORT statement. It draws a large frame with a large quadrangle in 
it as shown in the following figure titled “BASIC 2.0/2.1 and 3.0 without 


VIEWPORT”. 


10 GINIT 

20 GRAPHICS ON 

30 FRAME 

40 CLIP OFF 

50 MOVE 0,50 

60 DRAW 100,100 

70 DRAW RATIO*100,50 

80 DRAW 100,0 

90 DRAW 0,50 

100 END 
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If a VIEWPORT statement is placed in the program, BASIC 2.0/2.1 and 
BASIC 3.0 give different results. The program becomes: 

10 GINIT 

20 GRAPHICS ON 

30 VIEWPORT 80,100,20,80 

40 FRAME 

50 CLIP OFF 

60 MOVE 0,50 

70 DRAW 100,100 

80 DRAW RATIO*100,50 

90 DRAW 100,0 

100 DRAW 0,50 

110 END 

With BASIC 2.0/2.1, the result is a small frame with a large quadrangle 
around it (see figure titled “BASIC 2.0/2.1 with VIEWPORT”). The frame 
is what one would expect from the VIEWPORT; it is tall and thin. The 
quadrangle is the same as the one drawn by the program without the 
VIEWPORT because the VIEWPORT has not caused the DRAW’S to be 
rescaled. 
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With BASIC 3.0, the result is a small frame with a small quadrangle inside the 
frame (see figure titled “BASIC 3.0 with VIEWPORT”). The frame is the same 
frame as given by BASIC 2.0/2.1. The quadrangle fits inside the frame because 
the VIEWPORT in BASIC 3.0 causes all subsequent DRAW’S to be rescaled. 
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BASIC 3.0 with VIEWPORT 

The VIEWPORT change usually does not affect programs because most 
programs used a sequence such as: 

VIEWPORT 20,100,20,80 
WINDOW X«in,Xmax,Ymin,Ymar 

The result of these two statements in order is the same in BASIC 2.0/2.1 and 
BASIC 3.0. 

Some BASIC 2.0/2.1 programs used the following order: 

VIEWPORT 20,100,20,80 
WINDOW Xmin,Xmax,Ymin,Ymax 
VIEWPORT 0,100*RATI0,0,100 

The second VIEWPORT was used to change the soft clip limits. In BASIC 
2.0/2.1, the second VIEWPORT did not rescale so that the scale defined by 
the WINDOW and the first VIEWPORT remains effective. When the above 
sequence is run in BASIC 3.0, the second VIEWPORT rescales all subsequent 
plotting. 
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The best solution to this problem is to change the sequence to: 

VIEWPORT 20,100,20,80 
WINDOW Xmin,Xmax,Ymin,Ymax 
CLIP OFF 


The PIVOT Statement 

In BASIC 3.0, the local origin of RPLOT and LABEL is affected by the 
PIVOT statement. The best way to see the differences between BASIC 2.0/2.1 
and BASIC 3.0 is by studying the following examples. 



RPLOT with PIVOT 

The following program illustrates the effects of PIVOT on RPLOT statements. 
Outputs of the program with BASIC 2.0/2.1 and 3.0 are shown after the 


program. 


10 

DEG 

20 

GINIT 

30 

GRAPHICS ON 

40 

VIEWPORT 0,64,51,100 

50 

Pivot(0) 

60 

VIEWPORT 66,130,51,100 

70 

Pivot(30) 

80 

VIEWPORT 0,64,0,49 

90 

Pivot(60) 

100 

VIEWPORT 66,130,0,49 

110 

Pivot(90) 

120 

END 

130 

SUB Pivot(P) 

140 

WINDOW 0,131,0,100 

150 

FRAME 

160 

MOVE 30,80 

170 

LABEL "PIVOT",P 

180 

MOVE 40,20 

190 

PIVOT P 

200 

Tri 

210 

MOVE 80,20 

220 

Tri 

230 

PIVOT 0 

240 

SUBEND 

250 

SUB Tri 

260 

RPLOT 20,0,-1 
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270 

280 

290 


RPLOT 20,20 
RPLOT 0,0 
SUBEND 


PIVOT 0 

Zl Z 

PIVOT 30 

A A 

PIVOT 60 

a a 

PIVOT 90 


BASIC 2.0/2.1 RPLOT with PIVOT 
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PIVOT 0 

Zl Zl 

PIVOT 30 

PIVOT 60 

PIVOT 90 


BASIC 3.0 RPLOT with PIVOT 


LABEL with PIVOT 

The following program illustrates the effects of PIVOT on LABEL statements. 
Outputs of the program with BASIC 2.0/2.1 and 3.0 are shown after the 


program. 


10 

DEG 

20 

GINIT 

30 

GRAPHICS ON 

40 

VIEWPORT 0,64,51,100 

50 

FRAME 

60 

Pivot(0) 

70 

VIEWPORT 66,130,51,100 

80 

FRAME 

90 

Pivot(30) 

100 

VIEWPORT 0,64,0,49 

110 

FRAME 

120 

Pivot(60) 
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130 

VIEWPORT 66,130,0,49 

140 

FRAME 

150 

Pivot(90) 

160 

END 

170 

SUB Pivot(P) 

180 

WINDOW 0,131,0,100 

190 

MOVE 40,80 

200 

LABEL "PIVOT",P 

210 

MOVE 60,60 

220 

PIVOT P 

230 

IDRAW 0,0 

240 

LABEL "LI" 

250 

LABEL "L2" 

260 

LABEL "L3" 

270 

IDRAW 0,0 

280 

PIVOT 0 

290 

IDRAW 0,0 

300 

LABEL "L4" 

310 

LABEL "L5" 

320 

LABEL "L6" 

330 

SUBEND 
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c 


PIVOT 0 


PIVOT 30 

LI 


LI 

L2 


L2 

L3 


L3 

L4 


L4 . 

*L5 


L5 

L6 


L6 


PIVOT 


60 


LI 

L2 

L3 

L4 

L5 

L6 


PIVOT 


90 


LI 

L2 

L3 

L4 

# L5 

L6 


BASIC 2.0/2.1 LABEL with PIVOT 
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PIVOT 





LI 

L2 

L3 

L4 

*L5 

L6 


L4 


LI 

*L2 

L3 


L5 • 
L6 


PIVOT 


60 


PIVOT 90 


L4 

*L5 

L6 


LI 

*L2 

L3 


L4 LI 

L5 *L2 

L6 L3 


BASIC 3.0 LABEL with PIVOT 


Display Functions 

The effect of turning Display Functions mode on is to display special control 
characters on the screen. In BASIC 2.0/2.1, Display Functions has no effect 
on control characters 128 through 159. With BASIC 3.0, the appropriate 
character is displayed on the screen when control characters 128 through 159 
are displayed and Display Functions is enabled. For example, on a Model 236 
running BASIC 2.0/2.1, the following statement: 

PRINT CHR$(129)&“HI THERE"&CHR$(128) 
results in: 

HI THERE in inverse video 

With BASIC 3.0, the result is: 

h p HI THERE h p C R 
L 

F 

The symbols are machine dependent; the actual characters displayed may vary 
with other models. 
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Prerun On LOADSUB 

To speed the execution of the LOADSUB statement, BASIC 3.0 does not 
prerun each subprogram loaded by the execution of the LOADSUB statement 
if the subprogram has been stored in a “prerun state”. This differs from 
BASIC 2.0/2.1 in that BASIC 2.0/2.1 does prerun on the entire program every 
time LOADSUB is executed. The only effect seen by this change is improved 
performance when loading subprograms with the LOADSUB statement. For 
more information on prerun, refer to the “Program Structure and Flow” 
chapter. 


Special Case of I/O Transfers 

A special case of decreased I/O performance has occurred with BASIC 3.0 
due to a missed interleave caused by the increased overhead for handling 
multiple processors. Outbound transfers without DMA to the 913xA/B/V/XV 
Winchester disc drives perform at 11.75 Kbytes/second in BASIC 3.0. In 
BASIC 2.0/2.1, those transfers perform at a rate of 50 Kbytes/second. This 
degradation occurs only if all the following conditions are met: 

■ 8 MHz processor board (no cache) 

■ Not using DMA 

■ Using outbound TRANSFER (not OUTPUT) to 913xA/B/V/XV drive 

This performance degradation affects users who are logging test data onto 
their discs. Adding DMA can increase the outbound transfer rate to 50 
Kbytes/second. (Inbound transfers without DMA from those drives perform at 
11.75 Kbytes/second in both BASIC 2.0/2.1 and BASIC 3.0.) 
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Porting to Series 300 and 4.0 


Overview 

This chapter mainly focuses on one objective: 

■ Making BASIC programs which have been written for Series 200 computers 
run on Series 300 computers. (This process is known as “porting” programs.) 

Note if you are porting from a “pre-3.0” version of BASIC to the 4.0 

version, then you should also read the preceding “Porting to 
3.0” chapter. Anytime you see 4.0 mentioned in this chapter it 
also refers to all subsequent system versions. 


This chapter also discusses the following topics, which may not in all cases be 

directly related to porting existing Series 200 software to Series 300 computers: 

■ Configuring the built-in 98644-like RS-232C serial interface in Series 300 
computers. 

■ Using the “98203 keyboard compatibility” mode with ITF keyboards (such as 
the 46020 keyboard). 

■ Using the 98546 Display Compatibility Interface in your Series 300 computer 
(this interface provides the alpha and graphics capabilities of the Model 217 
computer). 
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Note 


If you are not porting BASIC 3.0 programs to Series 300 
computers (that is, if you will be using BASIC 4.0 on a Series 
200 computer), then much of the first part of this chapter 
may not pertain to you. The subsequent sections called 
“Modifying the Source Program (Porting to 4.0)” and “BASIC 
4.0 Enhancements for Series 200 Computers” will contain useful 
information for you. 


Methods of Porting 

Here are several methods of porting Series 200 software to Series 300 machines: 

■ Just load the program into a Series 300 computer—with no modifications— 
and run it. 

■ Write and run a program that properly configures the Series 300 computer 
for the program. 

■ Make your Series 300 computer emulate a Series 200 Model 217 computer 
(by installing a HP 98546 Display Compatibility Interface), and then run 
your unmodified Series 200 program on it. 

■ Modify your Series 200 BASIC source program, and then run it on a Series 
300 computer with the BASIC 4.0 system. 

Each method has a slightly different set of requirements for its use, as 

described subsequently. 
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Chapter Organization 

This chapter is organized according to the above strategies. It consists of the 
following sections: 

■ Description of Series 300 computer hardware, focusing on the enhancements 
to and differences from Series 200 computers 

■ Descriptions of porting methods, including when and how to use each: 
d Just loading and running programs 

□ Using configuration programs 

□ Using the “Display Compatibility Interface” 

□ Modifying the program’s source code 

Note Note that you may need to use more than one method in 

porting a program. For instance, you may need to write a 
configuration program and use the Display Compatibility 
Interface in order to port a program. 


Description of Series 300 Hardware 

Acquiring a general understanding of the enhancements or changes to Series 
200 computers provided by Series 300 computers will help you to choose a 
porting method. 
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Areas of Change 

Series 300 computers have changes in the following areas: 

■ Many choices of processor, display, and human interface boards: 

□ Six displays (including a separate, high-speed display controller) 

□ Two processors: MC68010, and MC68020 (with MC68881 math 
co-processor) 

□ Battery-backed, real-time clock 

□ RS-232C serial interface (similar to the 98644 serial interface) 

o ITF keyboard (“Integrated Terminal Family” keyboard, which is similar to 
Models’ 217 and 237 keyboards, but different from other Series 200 models’ 
keyboards) 

■ No ID PROM (not all Series 200 Models had this feature) 

Areas that Did Not Change 

It will probably be comforting to know that if a feature is not listed above (and 
discussed in this chapter), then it is the same for both Series 300 and Series 
200 computers. 

It may also be comforting to note that Series 300 computers can use most 
Series 200 accessories and peripheral devices. See the HP 9000 Series 300 
Configuration Reference Manual for a complete list. 

Displays 

Series 300 display technology is the most visible area of change from Series 200 
computers. 

All Series 300 computers utilize bit-mapped alpha display technology, which 
combines alpha and graphics like the display of the Series 200 Model 237. (All 
other Series 200 models have separate alpha and graphics.) 

The main difference between “non-bit-mapped” and “bit-mapped” alpha 
displays lies in whether or not alpha and graphics are separate. 
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■ With non-bit-mapped alpha displays, alpha is separate from graphics. Alpha 
is produced by character-generating hardware, while graphics are produced 
by bit-mapping hardware. 

(You can use the (alpha! and (graphics! keys to turn on alpha and graphics 
independently. When alpha is already on, pressing the (alpha! key turns off 
graphics. Similarly, pressing the (graphics! key while graphics is on turns off 
alpha.) 

■ With bit-mapped alpha displays, alpha and graphics are not separate. 

Both alpha and graphics are produced by a combination of software and 
bit-mapping hardware. 

(With BASIC 4.0, there is a way to configure the Series 300 color displays 
as separate alpha and graphics planes. This technique is described in the 
subsequent “Using a Configuration Program” section.) 

An effect of bit-mapped alpha is that both alpha and graphics are dominant. 

In other words, displaying a character on the screen overwrites all pixels within 
the character cell; the previous contents of those pixels, which may have 
been graphics, are lost. Also, any scrolling/clearing of the alpha screen will 
scroll/clear the graphics information on the screen, since they share the same 
display plane. Conversely, graphics operations overwrite alpha-related pixels. 

With Series 300 computers, you may choose from one of six displays: 
monochrome and color, each available in both medium-resolution (two 
monochrome and one color) and high-resolution (one monochrome and two 
color) versions. (Most Series 200 computers have only one display available for 
each model.) 

■ Medium-resolution graphics displays have 512 horizontal by 400 vertical 
pixels (many of the Series 200 graphics displays had 512x390-pixel graphics 
displays). 

(Series 300 medium-resolution displays actually have 1 024 horizontal 
pixels. However, BASIC graphics (but not alpha) handles contiguous pairs 
of horizontal (non-square) pixels as one unit in order to make square dots on 
the screen. Series 300 medium-resolution displays actually have 512 vertical 
pixels; however, only 400 are displayed.) 

Alpha capabilities of these medium-resolution displays are 80 columns of 
characters by 26 lines on-screen, plus 51 lines off-screen (as opposed to the 
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80x25-character alpha displays, with 39 lines off-screen, of many Series 200 
computers). The characters on Series 300 medium-resolution displays are in a 
12x 15-pixel cell. These displays have no blinking mode (except for the alpha 
cursor), and no half-bright mode. 

■ High-resolution displays have 1 024 horizontal by 768 vertical pixels. (Series 
300 high-resolution displays actually have 1 024 vertical pixels; however, only 
768 are displayed.) 

Alpha capabilities of high-resolution displays are 48 lines of 128 characters, 
with no lines off-screen, like the Model 237. The characters are in an 
8x 16-pixel cell. These Series 300 high-resolution displays also have no 
half-bright mode and no blinking mode (except for the alpha cursor on all 
Series 300 displays except the 98700 display controller). 


Processor Boards 

Two processor boards are available with Series 300 computers: 

■ Medium-performance boards, which feature an MC68010 processor (10 MHz 
clock rate). 

■ Higher-performance boards, which feature an MC68020 processor (16 MHz 
clock rate) and an MC68881 floating-point math co-processor. 

(Series 200 computers have either an MC68000 or MC68010 processor with an 
8 or 12.5 MHz clock, depending on model numbers and product options.) 

The 68010 is a 16-bit virtual memory microprocessor with a 32-bit internal 
architecture, while the MC68020 is a 32-bit microprocessor with an internal 
256-byte instruction cache (which is normally operative but can be disabled by 
executing CONTROL 32,3;0). 

The MC68020 also has a flexible co-processor interface that allows close 
coupling between the main processor and co-processors such as the MC68881 
floating-point math co-processor. The MC68881, which provides full IEEE 
floating-point math support, can execute concurrently with the MC68020 and 
usually overlaps its processing with the 68020’s processing to achieve higher 
performance. The MC68881 provides increased performance for floating-point 
operations, particularly for the evaluation of transcendental functions; refer to 
the “Efficient Use of the Computer’s Resources” chapter for further details. 
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(The MC68881 co-processor is normally operative, but you can disable it by 
executing CONTROL 32,2; 0.) 

Battery-Backed Real-Time Clock 

Series 300 computers have a built-in, battery-backed, real-time clock as well as 
a built-in volatile clock. Both have a lower limit of March 1, 1900. However, 
the upper limit of the volatile clock is August 4, 2079, while the upper limit of 
the non-volatile clock is February 29, 2000. 

(Only Series 200 Models 226 and 236 could have optionally installed 
battery-backed, real-time clocks. This hardware was included with the HP 
98270 Powerfail Option, whose main purpose was to provide power during 
brown-out or black-out situations.) 


Built-In Interfaces 

All Series 300 computers have a built-in HP-IB interface, which is the same as 
the built-in HP-IB interface of all Series 200 computers. 

Series 300 computers also feature the following built-in interfaces, which differ 
slightly from some of their Series 200 counterparts: 

■ RS-232C serial interface (like the HP 98644 low-cost serial interface). 

■ HP-HIL keyboard interface (like the one in Models 217 and 237) 

Serial Interface 

All Series 300 computers have a built-in, 98644-like, serial interface. As with 
Series 200 Models 216 and 217 built-in serial interfaces, this interface is 
permanently set to select code 9. However, this interface differs slightly from 
versions of the Series 200 built-in serial interface (which are like the optional 
HP 98626 serial interface). 
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Since the goal of the 98644 is to provide a low-cost serial interface, there are no 
hardware switches that allow you to specify values for the following parameters: 

■ Select code (hard-wired to 9) 

■ Interrupt level (hard-wired to 5) 

■ Default baud rate (the BASIC system sets default to 9600 baud) 

■ Default line control parameters (the BASIC system sets defaults to 8 
bits/character, 1 stop bit, parity disabled). 

If your program expects any other values for the baud rate and line control 
parameters, you will have to change them programatically (select code and 
interrupt level cannot be set programmatically). See “Using a Configuration 
Program” in this chapter for further information. 

HP-HIL Keyboard Interface 

Like the Series 200 Models 217 and 237 computers, Series 300 computers are 
equipped with ITF (“Integrated Terminal Family”) keyboards connected 
through an HP-HIL interface (Hewlett-Packard Human Interface Link). 

Note With BASIC 4.0 and subsequent system revisions, the HP 

98203C keyboard is also optionally available. This keyboard 
has the layout of the HP 98203B keyboard (and Model 226 and 
236 built-in keyboards), but it is connected to the computer 
through the HP-HIL interface. If you will be using this 
keyboard, you will not have to make any changes to programs 
that use the HP 98203B-style keyboard. 


Note If you are porting existing Series 200 software to Series 300 

and have already modified it to run on a Model 217 or 237 
computer’s ITF keyboard, then you have already made the 
adjustments necessary for this keyboard. If not, then continue 
reading this section. 


The major human-interface differences between 98203 keyboards and ITF 
keyboards are in the number and layout of “user” and “system” function keys. 
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Note that the ITF keyboard has only eight physical “user” function keys ( ffp 
through (f£), rather than (ko) through fk 9 ~)), and lacks some of the physical 
“system” keys (such as [alpha 1 and (run)). However, ITF keyboards actually 
have more functionality than 98203 keyboards, because BASIC provides 
several “system” and “user” definitions for ITF function keys (fi) through ffi~) . 
For complete definitions of each key on every keyboard, see the “Keyboard 
Reference” chapter of the Using BASIC manual. 

BASIC also provides a way to emulate the operation of a 98203 keyboard using 
an ITF keyboard. Using this mode is a convenient way of porting Series 200 
programs to Series 300 machines without modifying the source program. For 
further details of the “98203 compatibility mode”, see the subsequent “Using 
a Configuration Program” section. (A keyboard overlay is provided with the 
system to label BASIC definitions of several ITF keys. The subsequent “98203 
Keyboard Compatibility Mode” section describes the use of this overlay in both 
normal and compatibility modes.) 

Also note that the 98203 keyboards can produce some keycodes that cannot 
be produced with the 46020 keyboard. These keycodes are produced by 
pressing the ( execute 1 and (edit ) keys. Thus if the Series 200 program depends 
upon these keycodes, the source code must be modified. See the subsequent 
“Modifying the Source Program” section for further details. 

ID PROM 

Note that there is no built-in ID PROM available with Series 300 computers, 
as was the case with many models of Series 200 computers. However, an 
equivalent feature is provided by an optional HP-HIL device—the 46084A ID 
Module. 

If the program reads the ID PROM’s contents with a SYSTEM$( “SERIAL 
NUMBER”) function call, then the program will also read the ID Module’s 
contents correctly. See “Software Security” in the “Entering, Running, and 
Storing Programs” chapter for further information. However, if its contents 
were read by a CSUB (CSUB stands for Compiled SUBroutine, which is a 
program written in Pascal and generated using the CSUB Utility), then you 
will need to use a version that does not read the ID PROM. 
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Just Loading and Running Programs 

This is the most desirable method, since it requires the least amount of work 
just load the program into the Series 300 computer, and run it. 

You can probably port most of your BASIC 3.0 or 3.01 programs this way. 

There are three different actions you can take, depending on who developed 
your program: 

■ If HP developed the program, look in the “Operating Systems and 
Applications” section of the HP 9000 Series 300 Configuration Reference 
Manual. The manual shows which 3.0 or 3.01 applications will run on a 
Series 300 computer using the 4.0 system. 

■ If another software vendor developed the program, check with that vendor to 
determine whether it will run on a Series 300 computer. (You can also take 
one of the two actions listed below.) 

■ If you developed the program, you can do one of two things: 

□ Read through the following sections to see whether it requires another 
porting method. 

a Try running it. 

Should Problems Arise 

If your program will not run on your Series 300 system, then you may want to 
make considerations such as the following: 

■ Does it meet all of the criteria listed in the subsequent sections? 

■ Is there sufficient memory in the computer? 

■ Are all the necessary devices and corresponding device drivers installed? 

■ Have you fulfilled all other requirements listed by the software developer? 

If the program still doesn’t run, then you may want to call the organization 
responsible for supporting the program (the programmer, the software vendor, 
or HP). 
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Using a Configuration Program 

This method involves writing a program that configures the system for your 
program. Here are the situations for which this porting method will work: 

■ The program depends on a “non-default” 98626 serial interface configuration 
as set by hardware switches. 

■ The program depends on the 98203 keyboard layout (but does not depend on 
trapping the [execute! or (edit! keys). 

■ The program depends on separate alpha and graphics planes (and you have a 
Series 300 color display which you can configure to have separate alpha and 
graphics). 

HP 98644 Serial Interface Configuration 

Here is an example situation for which you could use this method. Suppose 
your program depends on reading the following “non-default” parameters from 
the configuration switches on the 98626-like, built-in serial interface in a Model 
217: 

■ 4800 baud 

■ 7 bits per character (with 1 stop bit) and odd parity. 

However, the default parameters for the built-in 98644-like interface in Series 
300 computers are as follows: 

■ 9600 baud 

■ 8 bits/character (with 1 stop bit), and parity disabled 

One solution is to use a short program that selects the desired “non-default” 
baud rate (4800) and line-control parameters (7 bits, odd parity). This 
example program changes the “default” parameters by writing to CONTROL 
registers 13 and 14. (Note that you can also execute these CONTROL 
statements directly from the keyboard.) 

100 CONTROL 9,13;4800 ! Baud rate. 

110 CONTROL 9,14;IVALC'llOOlOlO",2) ! No handshake (bits 7,6) 


120 ! 

130 ! 

140 END ! 


Odd parity (bits 5-3) 
1 stop bit (bit 2) 

7 bits/char (bits 1,0) 
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Enter and run this program on the 4.0 system, making sure that the SERIAL 
binary program is installed beforehand. The serial card is properly configured 
by this program, which you may want to verify by reading the corresponding 
STATUS registers. You can then run the application program. 

Another solution is to modify the source program to select these parameters 
(i.e., insert this segment of code into the program). In such case, you could 
change the “current” parameters by writing to CONTROL registers 3 (baud 
rate) and 4 (line control). However, if the interface is reset with the SCRATCH 
A statement, then the values in these registers will be restored to the “default” 
values currently in registers 13 and 14. See the BASIC Interfacing Techniques 
manual for details on the serial interface registers. 

HP 98203 Keyboard Compatibility Mode 

The BASIC system provides a mode of keyboard operation in which the 
ITF keyboards are compatible with (i.e., emulate) 98203 keyboards. Before 
describing how the compatibility mode works, it will be helpful to review each 
keyboard’s layout and normal operation. 

Brief Comparison of Keyboard Layouts 

Below are diagrams of each keyboard. They are shown here for the purpose of 
comparing their physical differences. For a key-by-key description of each one, 
refer to the “Keyboard Reference” setion of the Using BASIC manual. 

Here are the layouts of the 98203 keyboards: 


Porting to Series 300 and 4.0 19-13 






Softkeys 


Cursor 

Control Keys 


Editing 

Keys 


System 
Control Keys 



Chorocter Entry Keys 

HP 98203A Keyboard 


Cursor Editing 

Softkeys _ Control Keys Keys 


System 
Control Keys 



Chorocter Entry Keys 


Program 


Numeric Pod 
Control Keys 


HP 98203B and C Keyboards 

Note the “system” keys across the top of the keyboard (two rows across the top 
and one column down the middle of the larger 98203B; one row across the top 
and one column down the right side of the smaller 98203A). 

Softkeys on the 98203 keyboards are labeled (ko) through fk 9 ~) . There are 
corresponding “softkey labels” which can be displayed on the alpha screen. 
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For instance, you can enable the display of the default “typing-aid” labels by 
executing this statement: 

LOAD BIN "KBD" 

If this binary is already loaded and the “typing-aid” definitions are not 
currently displayed, execute LOAD KEY (with no file specifier). 

Here is the format of the 98203 softkey labels. (Note that they match the 
physical layout of the softkeys.) 


kO's . 

, label 

kl's . 

. label 

k2's 

label 

k3's ( 

, label 

k4's . 

. label 

k5‘s | 

f label 

k6's I 

[ label 

k7's I 

[ label 

</) 

00 

[ label 

k9's | 

label 


»<o 


kl 


k 2 1 

HUD 


k3 | 

HDD 


HDD HDD 

HP 98203 Softkey Labels 


M 1 

HDD 


There are 2 rows of 5 labels each. Each label consists of up to 14 characters. 
Contrast this layout to that of the ITF keyboards: 


Program 
Control Keys 


Softkeys ond 
Softkeys Control 


Editing System 

Keys Control Keys 


oo □□onnDonnn oo dotti 


99 

p 

r 










lL 

y 




Character Entry Keys Cursor Numeric 

Control Keys Keypad 


ITF Keyboards (such as the 46020) 
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Here are the default ITF “typing-aid” labels and corresponding keys. There 
is 1 row of 8 labels. Each label consists of up to 16 characters (2 rows of 8 
characters per label). 



HIL ‘Typing-Aid” Softkey Labels 


Even though the ITF keyboards have fewer physical function keys, they have 
more functionality than 98203 keyboards. This additional functionality is due 
to the fact that BASIC provides 1 menu of “system” keys (shown below) and 3 
menus of “User” definitions for softkeys (?T) through fra) . 

Here is the ITF “System” menu of keys, which you can display by pressing the 
[ Menu 1 key (if labels are not already displayed) and then the ( System ) key: 



HIL “System” Menu Labels 


This menu of softkey definitions provides most of the 98203 system key 
functions. 
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As you can see, there are two main areas of differences between 98203 
keyboards and ITF keyboards: 

■ There are several “system” keys on the 98203 keyboards, such as [step) , 
[continue) ( [cont ) on the smaller 98203A keyboard) and [recall! ( (rcl) on 
the 98203A). These system functions are not written on the key-cap labels of 
ITF keyboards, but the BASIC system functions are available on the System 
menu. 

■ Softkeys on the 98203 keyboards are labeled (ko) through (w). Thus, there 
are 20 softkeys available on the larger 98203 keyboards (by using [shift)), 
and 10 on the smaller 98203 keyboard. Softkeys on the ITF keyboard are 
labeled (7T) through (re). Thus, there are 24 softkeys available on these 
keyboards (3 menus of 8 keys each). The number and size of screen labels are 
also different. 


Enabling Keyboard Compatibility Mode 

You can enter this mode by writing a non-zero value into keyboard control 
register 15: 

CONTROL KBD,IS;1 

The following correspondence between function keys and labels is established 
(if you are in edit mode when you enter this compatibility mode, then edit 
mode is canceled): 


kO's 

k 1 's 

k2's 

k3's 

k4's 

k5's 

k6's 

k7's 

k8's 

k9's 

label 

label 

label 

label 

label 

label 

label 

label 

label 

label 


ITTTTTTTTi 

LZlD L f2 ] QD [ f * ] [ Menu ] [System] [ f5 ] [ f6 ] [ fl ] [ fa ] 

Correspondence Between Function Keys and Labels 

There is 1 row of labels, and each label may have up to 14 characters (two rows 
of 7 characters each). 
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If you want to fully emulate the 98203 keyboard and corresponding softkeys’ 
display behavior, you will need to execute the following statements: 

CONTROL CRT,12;0 
LOAD KEY 

The CONTROL statement sets up the “key labels display mode” to match 
the default behavior of a display with the 98203 keyboard. The LOAD KEY 
statement loads the default “typing-aid” softkey definitions for the 98203 
keyboards. 

Using Compatibility Mode 

Here is a listing of the correspondence between ITF keys and 98203 keys while 
in this mode. For a detailed description of each 98203 key’s function, see the 
“Keyboard Reference” chapter of Using BASIC manual. 

Note Place the BASIC keyboard overlays on the ITF keyboard 

before reading this section. Also note that you can use these 
overlays in normal mode as well as in compatibility mode. 
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■ To access a 98203 softkey definition, merely press the appropriate ITF 
softkey. For instance, the ITF (7T) softkey emulates the 98203 fko) softkey, 
and the ITF (Menu! key emulates the 98203 fkp softkey. (These key 
definitions are printed on the bottom row of the keyboard overlay.) 

Similarly, 98203 softkeys fig") through fkp are accessed by pressing the ITF 
f Shift 1 key with the appropriate softkey. 





f 1 

I 

f 2 

I 

f 3 

1 

f 4 

T 

Menu 


User 

System 


f 5 


f 6 


fl 


f8 


Step 


Continue 


RUN 


Print All 






Clr/Set Tob 

Disp Fctns 

Any Chor 

Recoil 


| kO 


kl 


k2 


k3 


k4 


k5 


k6 


k7 


k8 


kd 

□ 


■ To access a 98203 system-key definition, press (Extend char] with the 
appropriate ITF softkey. For instance, the ITF (Extend charhlfTl key emulates 
the 98203 (step) key. (These key definitions are printed on the top row of 
the keyboard overlay. Note that these definitions are the same as in the 
normal-mode System softkey menu.) 






f 1 


f2 


f 3 


f 4 


Menu 


User 

System 


f 5 


/ 6 


fl 


f8 



Step 


Continue 


RUN 


Print All 





Clr/Set Tob 

Disp Fctns 

Any Char 

Recall 



kO 


kl 


k2 


k3 


k4 


k5 


k6 


k7 


k8 


k9 
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■ The 98203 [clr l/o) and [pause) system-key definitions are available by using 
the ITF ( Break ) and (stop) keys (without pressing [Extend char) ). Note that these 
key definitions are the same in normal mode. 


Reset 


Stop 



f 1 


f 2 

Break 






- 

-i- L 


Reset Stop Step Continue 

Clear I/O Pause kO kl 


■ The 98203 [clr->end) , [clr ln) , and [clr scr) system-key definitions are 
available by using the ITF [Clear line) , [Shift) [Clear line) , and [Clear display) keys. 
Note that these key definitions are the same in normal mode. 


fl 


fQ 



Clear 


Clear 






line 


displa) 


Any Char 
k8 


Recall 

k9 


Clr Ln 


Clr^End Clr Scr 
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■ The 98203 (recall) , (alpha) , (graphics) , and JtES system-key definitions are 
available by using the unlabeled ITF keys above the numeric keypad. The 
shifted keys also have corresponding definitions (for example, (shift) - Alpha is 
the DUMP ALPHA function). Note that these key definitions are the same 
in normal mode. 


Clr Ln 

Clr->End Clr Scr 


Clear 


Clear 










line 


displa> 











Dump Alpha Dump Graph 


Recall Alpha Graphics Result 
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■ When shifted, the Q, 0, (+}, and Q ITF keys on the top row of the numeric 
keypad have the same definitions as the keys on the top row of the 98203 
numeric keypad. They are 0 ( (shift 0 ( (shift) - (71), 0 ( (shift ) - (+! ), and 
0 ( (Shift f D)- Note that these key definitions are the same in normal mode. 
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[Extend char H Menu 1 is an on/off toggle for the key labels. ( (Extend char hfshifp - 
(Menu ) produces no visible change.) 
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■ [Extend char H System) exits compatibility mode, and retu rns you to the ITF 
“System” key definitions. Similarly, [Extend chaTHuserj exits this mode, and 
returns you to the ITF “User 1” key definitions. (Note that there is no 
corresponding keystroke to return to compatibility mode.) 




User 

System 


f 5 


f6 


Continue RUN Print All 
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Exiting Keyboard Compatibility Mode 

In addition to using the [Extend char H System 1 and [Extend charj -(User J keys to exit 
this mode, you can also use keyboard register 15: 

CONTROL KBD,15;0 

If the system is currently in edit mode, then exiting keyboard compatibility 
mode will also cancel the edit mode. 
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If you were emulating the 98203 keyboard and corresponding softkeys’ display 
behavior (and want to return to the “normal” behavior), you will need to 
execute the following statements: 

CONTROL CRT,12;2 
LOAD KEY 

The CONTROL statement restores the “key labels display mode” to the 
default behavior of a display with the ITF keyboard. The LOAD KEY 
statement restores the default “typing-aid” softkey definitions for the ITF 
keyboard. 

Configuring Separate Alpha and Graphics Planes 

With BASIC 4.0 on bit-mapped color (multi-plane) displays, you have the 
ability to specify which planes are to be: 

■ write-enabled and used to display alpha 

■ write-enabled and used to display graphics 

This feature allows you to simulate separate alpha and graphics of Series 200 
displays. For instance, you will be able to: 

■ Turn alpha and graphics on and off independently. 

■ Dump them separately. 

■ Scroll alpha without scrolling graphics. 

An Example 

Assuming that you have a four-plane display, you could enable plane 4 for 
alpha and planes 1 through 3 for graphics. The following program performs 
this as well as some other operations, as described in the program’s comments 
(note that BASIC 5.0 provides the SEPARATE ALPHA FROM GRAPHICS 
statement to perform nearly the same functions as this program; see the 
BASIC Language Reference for details): 
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100 PLOTTER IS CRT,"INTERNAL";COLOR 

110 FOR 1=8 TO 15 

120 SET PEN I INTENSITY 0,1,0 

130 NEXT I 

140 CONTROL CRT,5;0 

150 OUTPUT KBD;CHR$(255)t"K"; 

160 CONTROL CRT,18;8 

170 CONTROL CRT,5;8 

180 INTEGER Gm(0) 

190 Gm(0)=7 

200 GESCAPE CRT,7,Gm(*) 

210 ! PLOTTER IS CRT,"INTERNAL" 

220 END 


MAP ! Select Series 300 graphics. 

! Set alpha pen colors (green). 

! Set alpha pen to black (temp.) 
! Clear alpha screen. 

! Select plane 4 for alpha. 

! Set alpha pen. 

! Declare array for GESCAPE. 

! Set bits 2,1,0, which select 
! graphics planes 3,2,1. 

! Return to non-color-map 
! mode (optional). 


This program provides eight graphics pen colors (either the default or 
previously defined colors) and a single alpha pen color (green). 

For more information concerning graphics displays, see the the “Multi-Plane 
Bit-Mapped Displays” section of the manual BASIC Programming Techniques, 
Volume II: General Topics and Graphics. For more information on alpha 
displays, see the “Display Interfaces” chapter of the BASIC Interfacing 
Techniques manual. 


Using the Display Compatibility Interface 

This method involves installing an HP 98546 Display Compatibility Interface, 
which consists of essentially the separate graphics and alpha boards of the 
Series 200 Model 217 computer. You can then direct the system to use the 
compatibility display, enabling you to run existing Series 200 programs, which 
depend on this display’s characteristics, on your Series 300 computer. 
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This card set remedies the following situations. 

■ The program depends on having separate alpha and graphics planes (and you 
do not have a color display which can emulate this feature, as described in 
the preceding “Configuring Separate Alpha and Graphics Planes” section). 

■ The program directly accesses alpha or graphics hardware (such as through a 
CSUB, rather than through a BASIC graphics statement). 

■ The program depends on blinking alpha display highlights (characters with 
codes 130, 134, and 135). 

■ The program depends on the Model 217’s specific graphics resolution 
(512x390 pixels) or alpha display size (80x25 characters), or upon its 
specific alignment of graphics pixels and alpha pixels. 

This method is required if any of the above statements is true and you cannot 
modify a program’s source code (or don’t want to). If you have the program’s 
source code, then you may want to instead make the necessary modifications to 
it. 

If your program requires separate alpha and graphics and also uses color, you 
have the option of using any color graphics display to drive a separate color 
monitor. Graphics can be displayed on this color monitor while alpha is display 
on the original monitor. 
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Hardware Description 

The card set consists of two circuit cards joined by a cable. 



These cards are: 

■ An alpha display card, which is like the existing 98204B display controller 
card except for a relay and an additional BNC video connector on the rear 
panel. 

■ A graphics display card, which is identical to the Model 217’s graphics card. 

The Relay and BNC Video Connectors 

The relay on the alpha card is used to switch between using the Series 300 
bit-mapped display’s signal and using the compatibility display’s signal. 
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Display Compatibility Interface Capabilities 

Capabilities of this card are identical to those of the Model 217. The alpha 
display is an 80 X 25-character screen with half-bright, blinking, underline, 
and inverse-video display enhancements. The graphics display is 512x390 
monochrome pixels. 

Configurations Possible 

Here are the video-interface/monitor configurations possible: 

■ Shared monitor: The Display Compatibility Interface and the Series 300 
bit-mapped display can share a medium-resolution monitor (monochrome or 
color). 

■ Separate monitors: The Display Compatibility Interface can use a 
medium-resolution monitor, and a Series 300 Video Board can use a separate 
monitor (monochrome or color, whichever is appropriate). 

■ Single monitor: The Display Compatibility Interface can use a 
medium-resolution monitor (with no Series 300 bit-mapped display). 


Steps in Using this Card Set 

Here are the steps you will take with this method: 

1. Turn off the computer. 

2. Configure and install the Display Compatibility Interface according to 
the instructions in its Installation Note. Also connect the monitor(s) as 
described in that note. 

3. Turn on the computer, and boot the BASIC system. 

4. Load the CRTA display driver binary, if not already installed. 

LOAD BIN "CRTA" [ Return 1 

5. Select the Display Compatibility Interface as the display device. 

CONTROL CRT,21; 1 (Return) 
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Note 


When using one monitor for two different displays (as in the 
“shared monitor” configuration described earlier), a small 
amount of time is required for the monitor to synchronize with 
the new display whenever you switch from one display to the 
other. It is normal for the screen to flicker when this switch is 
made. 


The preceding CONTROL statement also performs the following actions: 

■ Chooses and sets up the Display Compatibility Interface’s alpha display as 
appropriate: 

□ Sets all CRT registers to the appropriate default values. 

□ Clears the Series 300 bit-mapped display screen. 

□ Displays a cursor. 

□ Displays key labels (if appropriate) in half-bright mode. 

□ Displays a status indicator, such as the run light (if appropriate). 

(See “How the Default Alpha Display Is Chosen” in the “Display Interfaces” 
chapter of BASIC Interfacing Techniques. Items 1 and 2 are exchanged and 
a new selection of the “default display device” is made.) 

■ Chooses and sets up the Display Compatibility Interface’s graphics display 
by effectively initializing this display and executing GINIT and PLOTTER IS 
CRT,"INTERNAL". (The “default graphics display” is chosen according to the 
order listed under PLOTTER IS in the BASIC Language Reference.) 

Switching Back to the Series 300 Display 

The CONTROL statement is also used to select the Series 300 display: 

CONTROL CRT,21;0 (Return) 
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The preceding CONTROL statement performs the following actions: 

■ Chooses and sets up the Series 300’s alpha display as appropriate: 

□ Sets all CRT registers to the appropriate default values. 

□ Clears the Display Compatibility Interface’s alpha display. 

□ Displays a cursor. 

□ Displays key labels (if appropriate). 

□ Displays a status indicator, such as the run light (if appropriate). 

(See “How the Default Alpha Display Is Chosen” in the “Display Interfaces” 
chapter of BASIC Interfacing Techniques. A new selection of the “default 
display device” is made. Items 1 and 2 are not exchanged as in the switch to 
the Display Compatibility Interface.) 

■ Chooses and sets up the Series 300 graphics display by effectively 
initializing the bit-mapped display and executing GINIT and PLOTTER IS 
CRT, "INTERNAL". (The “default graphics display” is chosen according to the 
order listed under PLOTTER IS in the BASIC Language Reference .) 

Automatic Display Selection at System Boot 

When the BASIC system is booted with both the Display Compatibility 
Interface and the Series 300 bit-mapped display installed, it automatically 
selects one of them in the following manner: 

■ If only the CRTA driver is installed, the system selects the Display 
Compatibility Interface. 

■ If only the CRTB driver is installed (or if both CRTA and CRTB are 
present), the system selects the Series 300 bit-mapped display. 

If only the Display Compatibility Interface is installed, the system selects it as 
the display (CRTA must be currently installed, of course). For a more detailed 
description of how the BASIC system selects the “default display device,” see 
the “Display Interfaces” chapter of BASIC Interfacing Techniques. 
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Removing Display Drivers 

You can use SCRATCH BIN to remove all but the currently required display 
driver. In other words, if you are in compatibility display mode, then CRTB 
is removed. If you are in “native” Series 300 display mode (i.e., not in 
compatibility mode), then CRTA is removed. 

If Your Screen Is Blank 

Your screen can go blank (and characters you type in from the keyboard are 
not “echoed” on the screen) under the following conditions: 

■ You have both a Display Compatibility Interface and a Series 300 
bit-mapped display installed, and they are sharing the same monitor. 

■ You are not in compatibility mode (i.e., alpha is on the bit-mapped display). 

■ You are running a BASIC program that contains the following statement: 

PLOTTER IS 3,"INTERNAL" 

The execution of this statement causes your screen to go blank. You have just 
lost your alpha and graphics. 

What Happened? 

The PLOTTER IS 3, “INTERNAL” statement changed the current plotter 
device from 6 (bit-mapped display) to 3 (compatibility display). The system 
is talking to the compatibility cards, and the software-controlled relay that 
switches from the bit-mapped to the compatibility display has been (implicitly) 
directed to switch to the compatibility display’s video signal. However, the 
remainder of the operations performed by the CONTROL CRT,21;1 statement 
have not been performed. Therefore, you will not be able to see your alpha or 
graphics. 
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What To Do Next 

Temporary solution: You can do one of two things: 

■ To return to the bit-mapped display, first press the ( Reset i key, and then 
execute a SCRATCH A or CONTROL CRT,21;0 statement. 

■ To select the Display Compatibility Interface, execute CONTROL CRT,21;1. 

Note that you will not see any characters echoed on the display until you have 
executed one of the above statements. 

Long-term solution: Change all references to select code “3” to “CRT” (e.g. 
PLOTTER IS CRT,"INTERNAL"). 

Another Related Note 

If you want to determine how well your program runs on a Series 300 
bit-mapped display and this program executes a PLOTTER IS 3, 
“INTERNAL” statement, and you have Display Compatibility Interface 
installed, then you will not be able to adequately test the functionality of your 
software on a bit-mapped display unless you first remove the compatibility 
hardware (or change the PLOTTER IS 3, “INTERNAL” statements to 
PLOTTER IS CRT,“INTERNAL”). 


Modifying the Source Program 
(Porting to 4.0) 

This method involves changing or adding to the program’s source code to make 

an existing (pre-4.0) program perform the desired operations on the 4.0 system. 

Here are some, but not all, situations for which this method is required: 

■ The program depends on a CSUB with version 3.01 (or earlier). 

■ The program depends upon trapping HP 98203 f execute! or (edit! key codes, 
which cannot be generated by an ITF keyboard. 

■ None of the preceding porting methods worked. (In such case, you should 
read the subsequent “Additional Porting Considerations” section to see if 
your problem is described therein.) 
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If any of the above statements is true, then you must modify the program to 
run on the 4.0 system. If you do not have access to the source code, then you 
cannot port it—you will have to obtain a BASIC 4.0 version of the program, if 
it is available. 

Incompatible CSUBs 

An example of this situation is a program that depends upon using a “pre-4.0” 
CSUB. 

To remedy this situation, you will need to obtain a CSUB that is compatible 
with the BASIC 4.0 system. (This may require modifying the CSUB source 
program; it will definitely require re-generating a new CSUB with the CSUB 
4-0 Utility.) 

HP 98203 Specific Key Codes 

The 98203 keyboards can generate f execute) and (edit) key codes which 
cannot be generated by a 46020 keyboard. If your program depends on 
trapping these key codes, then you will need to modify it to use 46020 keys 
instead. For instance, you could trap the ITF ( Select ) key rather than the 98203 
f execute ) key. See the “Keyboard Interfaces” chapter of the BASIC Interfacing 
Techniques manual for examples of trapping keystrokes with a BASIC program. 


Additional Porting Considerations 

This section describes the following topics, which may also require 
consideration in porting programs from “pre-4.0” BASIC programs to the 
BASIC 4.0 system. 

■ New SYSTEM$(“SYSTEM ID”) values for Series 300 computers 

■ Alpha color changes on Series 300 color displays 

■ Alpha screen height and graphics scrolling 

■ GLOAD/GSTORE compatibility 

■ PLOTTER IS statement 

■ Hidden color changes 

■ ON KNOB “interval” parameter for HP-HIL knobs 
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New SYSTEM$(“SYSTEM ID”) Values 

On Series 300 computers, SYSTEMS(“SYSTEM ID”) will return two different 
values: 

■ S300:10 for computers with an MC68010 processor 

■ S300:20 for computers with an MC68020 processor 

Alpha Color Changes 

With multi-plane bit-mapped displays, printing one of the alpha color highlight 
characters, CHR$(136) through CHR$(143), will provide the same colors 
as on the Model 236C as long as the color map contains default values. A 
user-defined color map which changes the values of any pen in the range 0 
to 7 will consequently change the effect of the corresponding color highlight 
character. See “Display-Enhancement Characters” in the “Useful Tables” 
appendix of the BASIC Language Reference for more information. 

Alpha Screen Height and Graphics Scrolling 

With BASIC 3.0 and later versions, you can limit the height of the alpha 
portion of the screen. For instance, to limit the alpha portion of the screen to 
the bottom 11 lines, execute this statement: 

CONTROL CRT,13;11 

The screen height parameter of 11 specifies the number of lines to be used for 
the alpha screen (4 lines of “output area,” and 7 lines used by the system). 

The value of this parameter may not be less than 9. A corresponding STATUS 
statement will return the current screen height. 

This capability allows you to separate alpha and graphics on a single-plane 
bit-mapped display screen. You would also have to limit graphics to the upper 
portion of the screen (which is not used for alpha). 

GLOAD/GSTORE Compatibility 

Raster images loaded by GLOAD should have been stored (GSTORE) from the 
same type of display. Otherwise, if the image was stored on a machine with 
a different graphics resolution or number of bits per pixel, then the resultant 
image will be scrambled. 
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If your program first creates a graphics image and then GSTOREs and 
GLOADs it, then the image may be truncated (due to the difference in 
required array sizes). With BASIC 4.0, you can use the GESCAPE statement 
to determine the required array size. 

For example, the Model 236C requires an integer array size of 49 920 
elements to store information from the graphics planes in the frame buffer 
[(4 bits/pixel)x (512x390 pixels)/(16 bits/integer)], while a Series 300 
medium-resolution color display requires 102 400 elements (4x(1024x400)/16]). 
The value of 1024 is used because Series 300 medium-resolution bit-mapped 
displays have non-square-pixels. 

See GLOAD and GSTORE in the BASIC Language Reference for details 
concerning this topic. With BASIC 4.0, there are new utility CSUBs (Bstore 
and Bload) that allow you to store and load specified portions of the graphics 
raster. You may alternatively want to use these utilities in favor of using 
GSTORE and GLOAD. 

PLOTTER IS Changes 

There are several values that you can use when specifying the graphics display; 
however, the following examples show the best way: 

PLOTTER IS CRT,"INTERNAL" 

PLOTTER IS 1,"INTERNAL" 

CRT is a built-in function that always returns 1. The value of 1 signifies the 
“default display” (to the PLOTTER IS statement). 

The following statement, with select code of 3, specifies a non-bit-mapped 
display, if there is one; otherwise it is the same as PLOTTER IS 
1,“INTERNAL”. 

PLOTTER IS 3,"INTERNAL" 

The following statement always specifies a bit-mapped display. If one is not 
currently installed, then an error results. 

PLOTTER IS 6,"INTERNAL" 

Refer to the BASIC Language Reference for further details on the PLOTTER 
IS statement. 
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Hidden Color Changes 

On a Model 236C display, the following sequence of commands: 

GRAPHICS OFF 

SET PEN 0 INTENSITY 1,0,1 
GRAPHICS ON 

produces the following results. 

■ The GRAPHICS OFF statement will turn the graphics display off. 

■ SET PEN 0 is executed while the graphics screen is still blank and when the 
GRAPHICS ON statement is executed, the previous display contents with 
modified color map entry 0 is displayed. 

On the Series 300 and 98700 displays, the above command sequence produces 
the following results: 

■ If the alpha and graphics planes overlap (i.e. the default configuration), 
then GRAPHICS OFF and GRAPHICS ON are no-op’s, so the display will 
change immediately. 

■ If the alpha and graphics planes are totally independent (such as in 
“Configuring Separate Alpha and Graphics Planes” in the “Using a 
Configuration Program” section), then: 

□ GRAPHICS OFF turns the graphics planes off, leaving the alpha plane on. 

□ SET PEN n INTENSITY a,b,c will not be seen on the screen until the 
GRAPHICS ON statement is executed, unless n is equal to 0 or specifies 
an alpha pen. 

□ GRAPHICS ON turns on the graphics planes again. 

Note This occurs because alpha and graphics share the same color 

map on Series 300 and 98700 displays, and PEN 0 is the default 
alpha background color. 


HP-HIL Knob Interval Parameter 

The ON KNOB “interval” parameter for the optional HP-HIL knob (46083A) 
has been implemented in BASIC 4.0 (it was not implemented with HIL knobs 
in BASIC 3.0 or 3.01). This parameter works same way on an HIL knob as 
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on the non-HIL knob (built into Series 200 98203 keyboards). See the “Using 
the Knob” section of the “Communicating with the Operator” chapter of this 
manual. 


BASIC 4.0 Enhancements 
for Series 200 Computers 

Although the main objective of BASIC 4.0 was to add support of Series 300 
computers, it also added some additional features for Series 200 computer 
users (these enhancements also pertain to Series 300 computers). This section 
describes these enhancements. 

Note The new HP-HPL graphics devices, new foreign-language 

ITF keyboards, and HPHIL knob (see the “BASIC 4.0 
Enhancements or Series 200 Computers” tables below) can only 
be connected to computers with an HP-HIL interface. For 
Series 200 computers, it includes Model 217 and Model 237 
computers, and Model 220 computers with an optional HP-HIL 
interface. 
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BASIC 4.0 Enhancements for Series 200 Computers 


Hardware Enhancements 

Software Enhancements 

Support New HP-HILGraphics Devices: 

Tablets: HP 46087A (A size) HP 

46088A (B size) 

TouchScreen: HP 35723 

(Still use GRAPHICS INPUT IS, 
DIGITIZE, READ LOCATOR, etc.) Can 
determine maximum hard clip values with 
GESCAPE operation selectors 20 through 
22. (See the “Interactive Graphics” 
chapter of Graphics Techniques.) 

Ability to Specify Different Colors for 
Alpha Display Regions: 

CRT STATUS/CONTROL registers 5 
(modified definition) and 15 through 

Model 236C Only. 

17 (new). (See the BASIC Language 
Reference.) 

New Graphics Utilities: 

“Bstore” and “Bload” utilities allow 

No additional hardware is required. 

you to store and load specified portions 
of graphics rasters. “Gdump.rotated” 
allows you to dump graphics rotated by 
90°. (See the “BASIC Utilities Library” 
chapter of the Installing and Maintaining 
BASIC manual.) 
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BASIC 4.0 Enhancements for Series 200 Computers (continued) 


Hardware Enhancements 

Software Enhancements 

HP 98644A Serial Interface Registers: 

Less-expensive than HP 98626A (but has 
fewer “default” configuration switches). 

Interface STATUS/CONTROL registers 

13 and 14 allow you to read and change 
the “SCRATCH A defaults” to get the 
functionality of switches. (See the “Serial 
Interface” chapter of BASIC Interfacing 
Techniques.) 

HP 98203 KeyboardCompatibility Mode: 

None (useful with Models 217 and 237; 
also with 220 that uses the optional ITF 
keyboard). 

KBD CONTROL register 15 enables 
the ITF keyboard to emulate the HP 
98203B (Model 226/236) keyboard. (See 
the preceding “HP 98203 Keyboard 
Compatibility Mode” section of this 
chapter.) 

Support New Foreign-Language ITF 
Keyboards: 

Revised HIL “Swiss French*” and “Swiss 
German*” keyboards are now supported. 

SYSTEM$( “KEYBOARD 

LANGUAGE”) returns corresponding 
identifier. (See the BASIC Language 
Reference.) 

HPHIL Knob Interval Parameter: 

With BASIC 3.0, the interval parameter 
for ON KNOB was ignored for HIL 

None (same HIL knob as before). 

knobs. With 4.0, the parameter is used. 
(See the BASIC Language Reference.) 

Read “Keyboard Input” Line 
(Non-Destructively): 

Use SYSTEM$(“KBD LINE”). (See the 
“Communicating with the Operator” 
chapter of this manual.) 

None. 
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This chapter describes the differences and enhancements of BASIC 5.0 and 
BASIC 5.1. 

The BASIC 5.0 System is the latest revision of the “Series 200/300 
Workstation BASIC” product. It consists of miscellaneous new features which 
further enhance the capabilities of this language and operating system. This 
chapter describes the incremental features of BASIC 5.0, as well as describes 
the small changes made to some existing BASIC features. It will help you 
determine what to do when moving from the 4.0 to the 5.0 revision of this 
system. 


Compatibility with Previous Versions 

As with most other version changes to this BASIC language, the 5.0 revision is 

highly compatible with preceding versions. In other words, using the BASIC 

5.0 system: 

■ You can LOAD and RUN program (PROG) files created with STORE on 
previous versions of BASIC. 

■ You can GET and RUN program (ASCII) files created with SAVE on 
previous versions of BASIC. 

■ You can use all data files (BDAT and ASCII) created on previous versions of 
BASIC. (If you will be using the HFS directory format, then you should also 
read the “Porting and Sharing Files” chapter.) 

■ If you are using Compiled Subprograms (CSUB’s), you will have to 
regenerate them using the CSUB 5.0 Utility. 
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■ The BASIC editor is now in a separate binary (EDIT). If you require this, be 
sure to LOAD BIN “EDIT” before attempting to EDIT, LIST, or SAVE a 
program. 

■ The typing-aid softkey definitions have changed slightly from 4.0. If your 
application depends upon a particular typing-aid definition, then check to see 
whether it has changed. (If it has, then you can programmatically re-define it 
with LOAD KEY or SET KEY.) 


Categories of New Features 

This section describes the general categories of 5.0 features. They are presented 
roughly in the order you would encounter them while using the system. 
(Subsequent sections further describe each category, and list where they are 
described in the BASIC manuals.) 

■ New hardware supported 

■ New utilities 

■ Hierarchical File System (HFS) support 

■ Human interface enhancements 

■ Keywords that duplicate register operations 

■ General programming additions. 

■ New STATUS and CONTROL registers 

■ Additional support for HP-HIL devices 

■ Additional graphics capabilities 

■ Additional CSUB capabilities 
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New Hardware Supported 

BASIC 5.0 is supported with the new Model 330 and 350 computers. 

Note The Local Area Network (LAN) interface available with some 

of these models is not supported by BASIC. 


New Hardware Supported 


Computer 

Model 

BASIC Language Support 

Model 330 

Supported in “Main” system 
(no binary is required). 

Model 350 

Supported in “Main” system 
(no binary is required). 
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New Utilities 

The following utilities have been added to BASIC to simplify and speed up the 
installation, configuration, verification, and maintenance tasks. 


New Utilities 


New Feature 

New Utility 

Tutorial Information 

Can verify the operation of 
discs, printers, plotters, HP-HIL 
devices, and HP-IB graphics 
tablets. Also helps you to label 
your mass storage devices, 
printers, and plotters. 

Peripheral 

Verification 

Utility 

(VERIFY) 

“Verifying and Labeling 
Peripheral” chapter of 
Installing and Maintaining 
BASIC 

Can install BASIC on LIF and 
HFS hard and flexible discs, 
including formatting the disc 1 
and storing the BASIC system 
on the disc. 

System Disc Utility 
(DISC.UTIL) 

“Putting BASIC on a Hard 
Disc” chapter of Installing 
and Maintaining BASIC 

Can back up and restore entire 
disc and tape volumes, as well as 
individual files. Has the ability 
to specify files and directories 
with wildcards. (Uses the 

HP-UX cpio format.) 

Backup Utility 
(BACKUP). 

“Maintaining” section of 
Installing and Maintaining 
BASIC 

Can edit the display font in 
bit-mapped alpha displays, store 
the new font in a file, and load it 
at a later time. 

Font Editor Utility 
(FONT.ED) 

“BASIC Utilities Library” 
chapter of Installing and 
Maintaining BASIC 

Text editor and file-copy utilities 
called by pressing typing-aid 
softkeys. 

Memory-Resident 

Utilities 

(MEM.UTILS) 

“BASIC Utilities Library” 
chapter of Installing and 
Maintaining BASIC 


1 The System Disc Utility is also used to format and check the consistency of an 
HFS disc, as described in the next section. 
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HFS Disc Support 

The following features have been added to BASIC (with the HFS binary) to 
support the Hierarchical File System (HFS) format for discs and other mass 
storage devices. This file system is compatible with Series 200/300 HP-UX (5.0 
and later versions). 


HFS Disc Support 


New Feature 

Supporting 

System 

Component 

Tutorial Information 

BASIC, HP-UX, and Pascal 
can reside on the same mass 
storage volume 

System Disc Utility 
(DISC.UTIL) formats 
HFS volumes 

“Putting BASIC on a Hard 
Disc” chapter of Installing 
and Maintaining BASIC 

BASIC, HP-UX, and Pascal 
can access compatible files 
(ASCII and HP-UX). 

CREATE and 
ASSIGN 1 

“Porting and Sharing Files” 
chapter of this manual 

Hierarchical directories are 
supported (on both hard and 
flexible discs). 

HFS-formatted 

volumes 

“Using Directories and 

Files” chapter of Using 
BASIC 

Extensible files are available 

HFS files 

“Data Storage and 

Retrieval” chapter in volume 

1 of this manual 

Access to the HP-UX 
file-protection scheme (on HFS 
directories) 

PERMIT, CHGRP, 
and CHOWN 
statements 

“Using Directories and 

Files” chapter of Using 
BASIC 

Ability to detect and correct 
HFS inconsistencies 

System Disc Utility 
(DISC.UTIL) 

“Maintaining” section of 
Installing and Maintaining 
BASIC 


1 These are just a few of the I/O Operations (i.e. ENTER, OUTPUT, GET, 
etc. may also be included). 
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Note that time stamps are placed on HFS files whenever the BASIC system 
modifies the contents of the file. LIF files are also time-stamped with the 
BASIC 5.0 revision (previous versions did not do this). 


Human Interface Enhancements 

The following features have been added to the system to improve the BASIC 
system’s human interface. (The editor and lister were put into the EDIT 
binary so that the entire “main” system could fit on a single disc, not to 
“improve” the human interface. It does, however, allow you to have a 
“run-only” system which might be useful in some applications.) 
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Human Interface Enhancements 


New Feature 

Supporting 
System Component 
(Binary Required) 

Tutorial Information 

New textual “run light” on 
the screen (systems with ITF 
keyboards only). 

Enabled whenever 
softkey labels are on 
(No binary required) 

“Loading and Running 
Programs” chapter of Using 
BASIC 

Can clear the [RECALL] key 
buffer. 

SCRATCH R 
(No binary required) 

“Introduction to the 

System” chapter of Using 
BASIC 

New default typing-aid key 
definitions. 

No new keywords 
(No binary required) 

Various locations in Using 
BASIC 

Additional “sound” capabilities 
(on computers with HP-HIL 
interfaces) 

SOUND 
(KBD binary) 

“Communicating with the 
Operator” chapter in volume 

1 of this manual 

Redefinable character fonts 
(on bit-mapped alpha displays 
only). 

SET CHR, CHRX, 
and CHRY 
(CRTX binary) 

“Communicating with the 
Operator” chapter in volume 

1 of this manual 

Separated Program 

Editor/Lister (LIST) from main 
system 

EDIT, LIST, and 
SAVE moved to 

EDIT binary 

“Language Extensions, 
Drivers, and Configuration” 
chapter of Installing and 
Maintaining BASIC 

New BASIC statements to 
clear display regions (formerly 
performed with OUTPUT 

KBD) 

CLEAR SCREEN, 
CLEAR LINE 
(CRTX binary) 

“Communicating with the 
Operator” chapter in volume 

1 of this manual 

Can load individual (or 
all) typing-aid softkeys 
programmatically 

SET KEY 
(KBD binary) 

“Communicating with the 
Operator” chapter in volume 

1 of this manual 
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New Keywords that Duplicate 
Register Operations 

Several STATUS and CONTROL register operations have been duplicated by 
keywords which perform the same action. 


Keywords Duplicating Register Operations 


New Keyword 

Register Operation Duplicated 

DISPLAY FUNCTIONS ON 

DISPLAY FUNCTIONS OFF 

CONTROL CRT, 4; 1 

CONTROL CRT, 4; 0 

ALPHA PEN Pen.number 

CONTROL CRT,5;Pen.number 

KEY LABELS ON 

KEY LABELS OFF 

CONTROL CRT, 12;2 

CONTROL CRT, 12; 1 

ALPHA HEIGHT Lines 

ALPHA HEIGHT 

CONTROL CRT, 13;Lines 

Restores default (when Lines omitted) 

PRINT PEN Pen.number 

CONTROL CRT, 15; Pen_number 

KEY LABELS PEN Pen.number 

CONTROL CRT, 16;Pen.number 

KBD LINE PEN Pen.number 

CONTROL CRT, 17; Pen.number 

SET ALPHA MASK Mask.value 

CONTROL CRT, 18; Mask.value 

SET DISPLAY MASK Mask.value 

CONTROL CRT,20;Mask.value 

SYSTEM KEYS 

CONTROL KBD,2;0 

USER 1 KEYS 

CONTROL KBD,2; 1 

USER 2 KEYS 

CONTROL KBD, 2; 2 

USER 3 KEYS 

CONTROL KBD, 2; 3 

KBD CMODE ON 

KBD CMODE OFF 

CONTROL KBD, 15; 1 

CONTROL KBD, 15; 0 
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For tutorial information, see the “Display Interfaces” and “Keyboard 
Interfaces” chapters of BASIC Interfacing Techniques. (The KBD register 
statements are in the KBD binary; all others are in the CRTX binary.) 
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General Programming Additions 

The following features are used in BASIC programming. 


General Programming Additions 


New Feature 

New Keyword 
(Binary Required) 

Tutorial Information 

Complex math 

COMPLEX data type, 
supported in most 
math operations 
(COMPLEX binary) 

“Numeric Computation” 
chapter in volume 1 of this 
manual 

Hyperbolic functions 

SINH, COSH, TANH, etc. 
(COMPLEX binary) 

“Numeric Computation” 
chapter in volume 1 of this 
manual 

Searching arrays for patterns 
and conditions 

MAT SEARCH 
(MAT binary) 

“Numeric Arrays” chapter 
in volume 1 of this manual 

Copying subarrays 

MAT enhancement 
(MAT binary) 

“Numeric Arrays” chapter 
in volume 1 of this manual 

New string variable function 
(returns DIMensioned string 
length). 

MAXLEN function 
(No binary required) 

“String Manipulation” 
chapter in volume 1 of this 
manual 

Error-trapping feature 
enhancements. 

CAUSE ERROR, 

ERRLN, 

ERROR RETURN, 
ERROR SUBEXIT, 
CLEAR ERROR 
(No binary required) 

“Handling Errors” chapter 
in volume 1 of this manual 

Can programmatically 
specify which system to 
re-boot 

SYSBOOT 

enhancement 

(No binary required) 

BASIC Language 

Reference 
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New STATUS/CONTROL Registers 

The following new STATUS and CONTROL registers have been added in 
BASIC 5.0. 

New STATUS/CONTROL Registers 


New Register 

Definition 

STATUS 32,4;Batt_clock_type 

Returns the following values: 

0 => no battery-backed clock; 

1 => HP 98270 battery-backed clock 

(Models 226 and 236 only); 

2 => HP-HIL battery-backed clock. 

STATUS KBD, 16; Scroll.disabled 

Reading the STATUS register allows you to 
determine whether the PRINT area of the display 
can be scrolled by keystrokes or equivalent 
operations (the default is to allow scrolling). 

0 => scrolling enabled 

1 => scrolling disabled 

CONTROL KBD,16;Disable_scroll 

Writing a 1 to the CONTROL register disables 
scrolling (useful to prevent scrolling of alpha 
display; writing a 0 to the register enables 
scrolling). 

STATUS KBD, 17; Auto_menu 

Automatic menu switching: 

1 => enable (default) 

0 => disable 

CONTROL KBD, 17; Disable_auto 

Automatic menu switching: mode. 

<>0 => enable 

0 => disable 

This register controls whether a system with an 
ITF keyboard will switch to (from) the User 2 
Menu automatically on entering (leaving) EDIT 
mode. 
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See the “Clock and Timers” chapter of this manual for details on determining 
clock type. See the “Keyboard Interfaces” chapter of BASIC Interfacing 
Techniques for details of disabling scrolling. Also see the descriptions of these 
registers in the “Useful Tables” section of this manual or the BASIC Language 
Reference . 


Additional HP-HIL Support 

The following features provide greater support for Hewlett-Packard Human 
Interface Link (HP-HIL) devices. All of these capabilities require the KBD 
binary. 


Additional HP-HIL Support 


New Feature 

New Keyword 
(Binary Required) 

Tutorial Information 

Capability of setting 
up interrupts for and 
communicating with many 
HP-HIL devices (useful when 
writing your own HP-HIL device 
drivers) 

ON HIL EXT, 

HIL SEND, 
and HILBUFS 
(KBD binary) 

“HIL Devices” chapter 
of BASIC Interfacing 
Techniques 

Capability of setting up 
interrupts for and reading pulses 
from the HP 46085A Control 

Dial (9-knob) Box 

ON CDIAL, CDIAL, 
and OFF CDIAL 
(KBD binary) 

“Communicating with the 
Operator” chapter in volume 

1 of this manual 
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Additional Graphics Features 

The following graphics features have been added to the BASIC system. 


Additional Graphics Features 


New Feature 

Keyword 

(Binary Required) 

Tutorial Information 

New register that disables 
scrolling the display (to 
avoid scrolling graphics on 
bit-mapped alpha displays) 

CRT register 16 

) 

“Introduction to Graphics” 
chapter of BASIC Graphics 
Techniques 

Can now send HPGL commands 
to PLOTTER IS device or file. 

GSEND 

(GRAPH binary) 

“Using Plotters and 

Printers” chapter of BASIC 
Graphics Techniques 

Can simulate separate alpha 
and graphics rasters of Series 
200/300 displays with a single 
statement (formerly required a 
short program) 

SEPARATE ALPHA, 
MERGE ALPHA 

“Using Graphics Effectively” 
chapter of BASIC Graphics 
Techniques 
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Additional CSUB Capabilities 

The following capabilities have been added to CSUB’s (Compiled 
Subroutines—created using the Pascal Workstation System and CSUB Utility). 


Additional CSUB Capabilities 


New Feature 

General Capability 

Tutorial Information 

CSUB’s can 
now perform 

I/O operations. 

Categories of I/O procedures now 
available: 

■ Most of the Pascal I/O Procedure 
Library 

■ Some of the BASIC file I/O capabilities 

■ Some display I/O capabilities 

■ Some keyboard I/O capabilities 

■ All SYSTEMS capabilities 

CSUB Utility manual 


5.1 Enhancements 

BASIC 5.1 provides additional software capabilities and improvements in 
documentation. 
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New Capabilities 


New Feature 

Description 

PaintJet™ Support 
(HP 3630A Color 
Graphics Printer) 

A CSUB performs a color dump. See the “BASIC Utilities 
Library” chapter of the Installing and Maintaining the 
BASIC System manual. 

HP 98548A, HP 98549A, 
and HP 98550A 

Display Support 

These cards are high resolution bit-mapped display 
interfaces. (Note that on these displays, the alpha cursor 
will not blink.) 

New CSUB Utility 
Features 

Passing COMPLEX and I/O-path-name parameters to 
CSUB’s. See the BASIC 5.1 CSUB Utility manual. 

HP 98646A VME 
Interface CSUB 

This CSUB was formerly a separate product, but is now 
included in the BASIC 5.1 product (there are no new 
features). See the “BASIC Utilities Library” chapter of the 
Installing and Maintaining the BASIC System manual. 


Manual Changes 

In order to make the installation and maintenance of the BASIC Language 
System easier, the Installing, Using and Maintaining the BASIC System 
manual has been divided into two manuals: 

■ Installing and Maintaining 
m Using BASIC 

Duplicating Files with the LINK Command 

The COPY command creates a duplicate file by copying a file’s contents 
under a different file name. On the other hand, the LINK command creates 
additional filenames which refer to the same file. This is done by creating: 

■ A new file name (an entry in a directory). 

■ A pointer to the existing file’s contents (note that the contents are not 
duplicated). 
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Thus, LINK saves disc space, because there is only one copy of the body of the 
file (but there are two file names, or links, to the file’s contents). 

It is important to remember that the LINK command is usable only with HFS 
and SRM volumes. 

A Simple Example 

Executing the following statement: 

LINK "Existing_file" TO "Nes.name" 

links the file name called New_name to the existing file called Existing_f ile. 


Characteristics of Linked Files 

As mentioned before, LINK makes a new name and creates a pointer to 
an existing file. This gives the file some useful, but sometimes subtle, 
characteristics. For instance, an OUTPUT to a data file will change its 
contents. Using ENTER with any file linked to the changed file will reflect the 
change. (Note that there is only one copy of the file’s data but two or more file 
names are linked to it.) 

If you RE-STORE or RE-SAVE a file that is linked to other files, a new file 
will be created and the link to the original file will be broken. In this case 
the RE-STORE’d or RE-SAVE’d file is changed but the linked files are not 
changed. 

The keyword LINK is like the COPY command and in some cases they can be 
used interchangeably. However, COPY results in two different files, while LINK 
results in one file with two different file names linked to it. LINK is used when 
you need to save disk space or you want the OUTPUT command to change the 
contents of all linked files. COPY should be used if you want OUTPUT to 
modify one version of the file but not all versions. 

More Examples of Creating Linked Files 

The first example below creates an HP-UX file and links it to another file. It 
then outputs data to the original file. Finally the contents of each file (which 
are identical) are displayed. 

100 CREATE "File_l",l ! Create an HP-UX file. 

110 ! 
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120 

LINK "File.l" TO "File_2" ! 

Link "File_2" to "File_l". 

130 

; 


140 

ASSIGN ®File_l TO "File.l" ! 

Open File.l for writing. 

150 

; 


160 

String$="This is a test." ! 

Assign the output string. 

170 

OUTPUT «File_l;String$ ! 

Output message to all linked files 

180 

i 


190 

ASSIGN «File_l TO * ! 

Close File.l before reading it. 

200 

; 


210 

ASSIGN «File_l TO "File_l" 

! Open File_l for reading. 

220 

ENTER ®File_l;StringlS 

! Read «File_l into Stringl$ 

230 

PRINT "The contents in File. 

.1: ";Stringl$ ! Print Stringl$ 

240 

ASSIGN «File_l TO * 

! Close File_l 

250 

i 


260 

ASSIGN «File_2 TO "File_2" 

! Open File_2 for reading. 

270 

ENTER ®File_2;String2$ 

! Read «File_2 into String2$ 

280 

PRINT "The contents in File. 

.2: ";String2$ ! Print String2$ 

290 

ASSIGN ®File_2 TO ♦ 

! Close File_2 

300 

1 


310 

END 


Here are 

the results of running the program: 

The 

contents in File_l: This is 

a test. 

The 

contents in File 2: This is 

a test. 


Example of Breaking a Link 

The next example shows how RE-STORE breaks a link. Create the program: 

10 PRINT "Original Program" 

20 END 

Next give this file the name Original and store and create a link to it: 

STORE "Original" 

LINK "Original" TO "New.name" 

Modify the program called New.name to read: 

10 PRINT "Modified Program" 

20 END 
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Now store the program using the RE-STORE command: 

RE-STORE "New_name M 

If you next LOAD the program called Original and LIST it, you will find 
that it remains unchanged because the link between Original and New.name 
is broken. (That is, there are now two files on the system, each being slightly 
different from the other.) 
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Porting and Sharing Files 


There are three different types of mass storage formats supported by BASIC: 

■ Logical Interchange Format (LIF) 

■ Shared Resource Manager (SRM) 

■ Hierarchical File System (HFS) 

With each of these types of formats, BASIC supports three types of data files, 
as well as other types of files used by the BASIC system: 

■ ASCII 

■ BDAT 

■ HP-UX 

■ PROG 

■ BIN 

■ SYSTM 

This chapter describes what tasks you will need to perform in transporting 
BASIC files from one type of volume to another. It also describes how to share 
HP-UX files between Series 200/300 BASIC, HP-UX, and Pascal systems. 
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Sharing HFS Discs and Data Files 

With the introduction of BASIC 5.0, it is now possible to share data files 
between BASIC applications and HP-UX applications using HFS volumes. 

This allows you to develop a total solution that takes advantage of the best 
features of each available operating system. 

■ As an example, a system can use BASIC for instrument control or automated 
data acquisition and then use HP-UX applications to analyze or manipulate 
the data for statistical quality control or management information systems. 

■ HP-UX also allows a gateway to networking capabilities that are becoming 
an important part of information sharing in the factory. 

■ Another advantage of HP-UX is the availability of the HP-UX Starbase 
Graphics Library and Graphics Hardware, which provides many additional 
graphics features that are not available with the BASIC Operating System. 

General Compatibility Requirements 

In order to share data files between BASIC and HP-UX, there must be 
compatibility of: 

■ File types (both operating systems must be able to read and write a file to be 
shared) 

■ Data representations (both operating systems must write and interpret the 
bytes in the file in the same manner) 

These requirements will be explored here, and examples of sharing data files 
between BASIC and HP-UX will be shown. 

A Note About HP-UX File Terminology 

From the following matrices, we see that BASIC and HP-UX can easily share 
files of “type HP-UX”: 

■ On BASIC, these files will be listed with CAT as being of type HP-UX. 

■ On HP-UX, these files will be listed as text or data, depending on the 
contents of the file. 


21-2 Porting and Sharing Files 






From the HP-UX viewpoint, this type of file can be called an “HP-UX text” 
file or an “HP-UX binary” file. The U HP-UX text” file contains data written in 
ASCII representation, while the “HP-UX binary” file contains data written in 
internal representation. 
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Common File Types 

The following matrix shows which file types are supported by each operating 
system available on Series 300 computers. 


Data File Support Matrix 


Operating System 
or language 

ASCII 

BDAT 

Pascal 

Text 1 

HP-UX 

BASIC 4.0 (or earlier) 

Y 

Y 



BASIC 5.0 (or later) 

Y 

Y 


Y 

Workstation Pascal 3.12 (or earlier) 

Y 


Y 


Workstation Pascal 3.2 (or later) 

Y 


Y 

Y 

Technical BASIC 




2 

HP-UX C 

3 



Y 

HP-UX Pascal 

3 



Y 

HP-UX FORTRAN 

3 



Y 

MS-DOS 

4 





Legend: 

1 “Pascal Text” files include type “.TEXT” files and type “Data” files that 
contain text. 

Y means that the Operating System or Language can easily read or write 
the file type with a native language program. 

2 HP-UX Technical BASIC can only handle HP-UX files that contain text. 

3 HP-UX has utilities to transfer LIF files to HFS volumes (lif cp, etc.). 

4 Utilities are available for MS-DOS to transfer LIF files. 
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Common Data Types 

Once a common file type to be used has been identified, the next step is to 
determine the data types that can be used within the file. To share data 
within a file between BASIC and HP-UX, the data type must be a type that 
is supported in both operating systems. The following matrix shows which 
data types are supported by each operating system available on Series 200/300 
computers. 


Data-Type Support Matrix 


Operating 
System or 
Language 

16-Bit 

Integer 

32-Bit 

Integer 

32-Bit 

Real 

64-Bit 

Real 

128-Bit 

Complex 1 

String 

Null-Ter¬ 

minated 

String 

BASIC 4.0 
(and earlier) 

Y 



Y 


Y 


BASIC 5.0 
(and later) 

Y 



Y 

Y 

Y 

2 

Workstation Pascal 
3.12 (and earlier) 

Y 

Y 


Y 


Y 


Workstation Pascal 
3.2 (and later) 

Y 

Y 


Y 


Y 


Technical BASIC 


Y 

Y 

Y 


Y 


HP-UX C 

Y 

Y 

Y 

Y 


Y 

Y 

HP-UX Pascal 

Y 

Y 

Y 

Y 


Y 


HP-UX Fortran 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

MS-DOS 

Y 

Y 

Y 

Y 


Y 

Y 


Legend: 

1 The 128-bit complex data type is equivalent to two 64-bit reals. 

Y means that the Operating System or Language can easily read or write 

the data type with a native language program. 

2 This data type works with “HP-UX binary” data files only. 
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From this matrix, we see that BASIC and HP-UX can easily share data that is 
16-bit integer, 64-bit real, 128-bit complex, string, and null-terminated strings. 
Before you can access this data, however, you must know: 

■ Which data types are used in the file. 

■ The order in which they are used. 

Then you can use the corresponding data types in the programming language 
while reading the data. For example, BASIC and HP-UX C must have this 
data type matching to share data: 


Data-Type Matching Between BASIC and C 


BASIC 

c 

INTEGER 

short 

REAL 

double 

COMPLEX 

2 double’s 

String 

array of char 


HP-UX Text and Binary Files 

“HP-UX text and binary” files are the native file types supported by HP-UX 
on HFS volumes. Support for this data file type has been added in BASIC 5.0 
to allow sharing data files with HP-UX applications. BASIC still retains full 
support for all existing data file types, ASCII and BDAT, but some keywords 
have been updated to provide support for HFS discs and HP-UX text and 
binary files. 

In particular, the ASSIGN, OUTPUT, and ENTER keywords now support 
“HP-UX text” and “HP-UX binary” files. (Note once again that these are both 
considered to be an HP-UX file type in BASIC; the only difference is in the file 
contents.) 

A new CREATE statement has also been added to allow HP-UX files to be 
created from the BASIC system. To create an HP-UX file, use the CREATE 
keyword without the BDAT or ASCII secondary keywords. 

CREATE "HPUX_file M ,10 
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When the ASSIGN statement is executed to open a file, the file type in the file 
header is examined. If the file is BDAT or ASCII, it will be treated as such. 
Otherwise, the file will be treated as: 

■ An “HP-UX binary” file (if it is assigned with FORMAT OFF) 

■ An “HP-UX text” file (if it is assigned with FORMAT ON). 


Examples of HP-UX File Access: Textual Numeric Data 

Some examples will demonstrate how to access an HP-UX text file from BASIC 
and from HP-UX. The first program below is a BASIC program that writes 
some real numbers into an HP-UX text file. 

10 ! RE-STORE "SHARE.TEXT" 

20 ! 

30 ! Create ft Assign the output file. 

40 ! 

50 CREATE n TEXT_DATA M ,1 ! Create an HP-UX file. 

60 ASSIGN flFile TO M TEXT_DATA M ;FORMAT ON ! Treat as "text" file. 

70 ! 

80 ‘ Output the data to the HP-UX Text file. 

90 ! 

100 FOR N=-9.0 TO 8.5 STEP .07 
110 OUTPUT GFile;N 
120 NEXT N 
130 ASSIGN CFile TO * 

140 ! 

150 END 

In this BASIC program, the file TEXT_DATA is an HP-UX file into which 
this program writes 250 real numbers. The ASSIGN statement is performed 
with FORMAT ON, thus specifying that this file is to be treated as a 
“text” file—using the ASCII data representation. (Note that the default 
FORMAT attribute for an HP-UX file is FORMAT OFF.) This program also 
demonstrates that file access of an “HP-UX text” file is performed with the 
same statements that would be used for access of an ASCII or BDAT file. 

The next program is an HP-UX C program to read the data file that the above 
BASIC program wrote. 


tinclude <stdio.h> 
mainO 
{ 
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float X, Y; 

FILE *datafile, *fopen(); 

/*** ***/ 

/*** Open file to read data ***/ 

/*** ***/ 

datafile * fopen("/users/workstation/basic/files/TEXT_DATA", M r M ); 
if (datafile == NULL) { 

printf("Can’t open file An"); 
exit(l); 

} 

/*** ***/ 

/*** Get data from file and print data ***/ 

/*** ***/ 

for (X = 1.0; X <= 250.0; X += 1.0) { 
fscanf(datafile, "%f", AY); 
printf ("B\n",T) ; 

> 

fclose(datafile); 

> 

In this HP-UX C example, the file TEXT_DATA is the “HP-UX text” file into 
which the BASIC program wrote 250 real numbers. Note that the HP-UX C 
program reads these real numbers as strings with the “fscanf’ routine, then 
converts each string back to the real number value with the “%f’ conversion 
specification. 


Note Data in an “HP-UX text” file is stored as ASCII characters, 

and this data can be read and edited by HP-UX editors or read 
by HP-UX commands such as “cat” and “more”. 
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The next program is an HP-UX Technical BASIC program to read the data file 
which the preceding BASIC program wrote. 


10 CLEAR 
20 REAL x,y 
30 name$= M TEXT_DATA" 
40 ASSIGN 14 TO name$ 
50 FOR x=l TO 250 
60 ENTER 14 ; y 
70 PRINT x,y 
80 NEXT x 
90 ASSIGN 14 TO 
100 END 


This HP-UX Technical BASIC example reads the file TEXT-DATA into which 
the BASIC program wrote real numbers. Note that Technical BASIC can 
convert each string back to the real number value with the number builder in 
the ENTER statement. This program demonstrates the simplicity of HP-UX 
Technical BASIC when used for sharing files between HP-UX Technical BASIC 
and the BASIC workstation environment. 

Below is the hexadecimal dump of the first 40 bytes of the file TEXT-DATA, 
which will be used to get a better understanding of how BASIC formatted 
the data when it wrote to this “HP-UX text” file; contrast it to the following 
ASCII dump of the same file. (A listing of the program is shown at the end of 
this chapter.) 


Contents of TEXT_DATA 

BYTE I +0 I +1 I +2 I +3 I +4 | +5 I +6 I +7 I +8 I +9 I 

- + - + - + - + - + - + - +-+-+-+-+ 

0 I 2d I 39 I d I a I 2d I 38 I 2e I 39 I 33 I d I 

10 I a I 2d I 38 I 2e I 38 I 36 I d I a I 2d I 38 I 

20 I 2e I 37 I 39 I d I a I 2d I 38 | 2e | 37 I 32 I 

30 I d I a | 2d | 38 | 2e | 36 | 35 | d I a I 2d I 

HP-UX Text File Contents 
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Here are the contents of the first 40 bytes of the file TEXT-DATA, shown in 
hexadecimal format. To show that the data items in an “HP-UX text” file are 
ASCII characters, the ASCII equivalent of this same data is now shown below. 


byteI +o I 

- + - +• 

0 1 - I 

10 I "LF" I 
20 I .1 
30 I "CR" | 


+1 I +2 I +3 I +4 I +5 I +6 I +7 


+8 I +9 I 


-+-+-+• 

9 I "CR" I "LF" I 

- I 8 1 . | 

71 9 I "CR" | 

"LF" I - I 8 | 


- + - + - + 

- I 8 1 . I 

8 I 6| "CR" I 

"LF" I - I 8 I 

.1 6 1 5 1 





9 1 

3 

1 "CR" I 

LF" I 

- 

1 8 | 

. 1 

7 

1 2 I 

CR" I 

"LF" 

1 - 1 


ASCII Character Equivalent 


This table shows that a real number output to the HP-UX text file by BASIC 
is output as a string of ASCII characters representing the real number and this 
real number string terminated by “CR” and “LF” characters. 


Examples of HP-UX File Access: Textual Strings 

The next data type to be demonstrated will be strings. The first program 
below is a BASIC program that writes some strings into an “HP-UX text” file. 


10 

! RE-STORE M SHAREJSTR2 M 


20 

i 


30 

INTEGER N 


40 

; 


50 

! Create k Assign the output file. 


60 

i 


70 

CREATE M STR2_DATA M ,1 ! 

Create 

80 

ASSIGN CFile TO "STR2_DATA M ;FORMAT ON ! 

Treat i 

90 

i 


100 

! Output the strings to the data file 


110 

i 


120 

FOR N=-9 TO 240 


130 

OUTPUT CFile; "This is "*TRIM$(VAL$(N))ft" line 1 

140 

NEXT N 


150 

ASSIGN flFile TO * 


160 

i 


170 

END 



In this BASIC example, the file STR2-DATA is an “HP-UX text” file into 
which this program writes 250 data strings. The ASSIGN statement is again 
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performed with FORMAT ON to specify that the data are to be represented in 
ASCII format (an “HP-UX text” file). 

The next program is an HP-UX C program to read the data file that the above 
BASIC program wrote. 

tinclude <stdio.h> 
mainO 
{ 

int X; 

char Stmg [40] ; 

FILE *datafile, *fopen(); 

/*** ***/ 

/*** Open file to read data ***/ 

/*** ***/ 

datafile = fopen("/users/workstation/basic/files/STR2_DATA M , "r"); 
if (datafile == NULL) { 

printf("Can't open file.\n"); 
exit(1); 

> 

/*** ***/ 

/*** Get string data from file and print data ***/ 

/*** ***/ 

for (X = 0; X <= 249; X += 1) { 

fgets(Strng, 40, datafile); 
printf ( M 7.s",Strng) ; 

> 

fclose(datafile); 

> 

In this HP-UX C example, the file STR2.DATA is the “HP-UX text” file into 
which the BASIC program wrote 250 data strings. Note that the HP-UX C 
program reads these data strings into an “array of char” with the “fgets” 
routine. The “fgets” routine used here terminates with the new-line character, 
then replaces this new-line character with a NULL character. 
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Below is the hexadecimal dump of the first 40 bytes of the file STR2.DATA, 
which will be used to get a better understanding of how BASIC stored the 
strings when it wrote to this “HP-UX text” file. 

BYTE I +0 I +1 I +2 I +3 I +4 I +5 I +6 I +7 I +8 I +9 I 

- + - + - + - + - + - + - +-+-+-+-+ 

0 | 54 I 68 I 69 I 73 I 20 I 69 I 73 I 20 I 2d I 39 I 

10 | 20 I 6c I 69 I 6e I 65 I d I a I 54 I 68 I 69 I 

20 I 73 I 20 I 69 I 73 I 20 I 2d I 38 I 20 I 6c I 69 I 

30 I 6e I 65 I d I a I 54 I 68 I 69 I 73 I 20 I 69 I 

HP-UX Text File Contents with Strings 

These are the contents of the first 40 bytes of the file STR2-DATA, shown in 


hexadecimal format. To prove 

that the data in an 

“HP-UX text” 

file is 

ASCII 

characters, the ASCII equivalent of this same data is now 

shown below. 


BYTEI +01+11+21 

+3 1 

+4I+5I 

+6 I 

+7 1 

+8 I 

+9 1 

— +-+-+— 

0 1 T 1 hi i 1 

s 1 

1 i 1 

8 1 

i 

- i 

9 1 

10 I 1 1 1 i 1 

n I 

e I "CR" 1 

"LF" I 

T 1 

h I 

i 1 

20 I s I 1 i 1 

8 1 

1 - 1 

8 1 

1 

1 1 

i 1 

30 I n I el "CR" 1 ' 

"LF" I 

T I h I 

i 1 

8 1 

1 

i 1 

ASCII Character Equivalent 





This table shows that a string output to the HP-UX text file by BASIC is 
output as a string of ascii characters with no added length header bytes and 
terminated by “CR” (carriage-return) and “LF” (line-feed) characters. 

Examples of HP-UX File Access: Binary Real Values 

There are three different types of data that can be stored in an HP-UX file 
that BASIC can also access. These data types are REAL, INTEGER, and 
string. The first type to be demonstrated in examples will be files of REAL 
data. The first program below is a BASIC program that writes some REAL 
numbers into an “HP-UX binary” file. 
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RE-STORE M SHARE_REAL' 


10 
20 

30 ! Create ft Assign the output file. 

40 ! 

50 CREATE "REAL.DATA",1 

60 ASSIGN CFile TO M REAL_DATA M ;FORMAT OFF ! Treat as "binary” file. 

70 ! 

80 ! Output the real numbers to the data file 

90 ! 

100 FOR N=-9.0 TO 8.5 STEP .07 
110 OUTPUT CFile;N 
120 NEXT N 
130 ASSIGN CFile TO * 

140 ! 

150 END 

In this BASIC program, the file REAL-DATA is an HP-UX file into which 
this program writes 250 real numbers. Note that the ASSIGN statement is 
performed with FORMAT OFF, thus specifying that this file is to be written 
as internal representation numbers. This program also demonstrates that file 
access of an “HP-UX binary” file is performed with the same keywords that 
would be used for access of a BDAT file. 

The next program is an HP-UX C program to read the data file that the above 
BASIC program wrote. 
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♦include <stdio.h> 
mainO 
{ 

int X; 

double Y[250]; 

FILE *datafile, *fopen(); 

/*** ***/ 

/*** Open file to read data ***/ 

/*** ***/ 

datafile = fopen("/users/workstation/basic/files/REAL_DATA", M r M )5 
if (datafile == NULL) { 

printf("Can’t open file.\n M ); 
exit(l); 

} 

/*** ***/ 

/*** Get real data from file and print data ***/ 

/*** ***/ 

fread((char *)Y, sizeof (Y[0] ) , 250, datafile); 
for (X = 0; X <= 249; X += 1) 
printf("7,f\n",Y[X]); 
fclose(datafile); 

> 

In this HP-UX C example, the file REAL.DATA is an “HP-UX binary” file 
into which the BASIC program wrote 250 real numbers. Note that the HP-UX 
C program reads these real numbers into an array of double with the “fread” 
routine. This data must be handled as type double in C to remain compatible 
with the 64-bit real format used in BASIC. This data cannot be read and 
edited by HP-UX editors or read by HP-UX commands such as “cat” and 
“more”. However, this data representation may allow for more efficient disc 
space use since every real number takes 8 bytes of disc space. The I/O transfer 
rates are also higher, since neither the output or the input routines need to 
format the data. In many cases, the internally represented numbers provide 
greater accuracy than would an ASCII representation of the number. 
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Below is the hexadecimal dump of the first 40 bytes of the file REAL-DATA, 
which will be used to get a better understanding of how BASIC represented the 
real number data when it wrote to this HP-UX (or “HP-UX binary”) file. 


BYTEI 

+0 

1 +1 

1 +2 

1 +3 

1 +4 

1 +5 

1 +6 

1 +7 

1 +8 

1 +9 1 

0 1 

cO 

1 22 

1 0 

1 0 

1 0 

1 0 

1 0 

1 0 

1 c0 

1 21 | 

10 I 

dc 

1 28 

1 f 5 

1 c2 

1 8f 

1 5c 

1 cO 

1 21 

1 b8 

1 51 I 

20 I 

eb 

1 85 

1 le 

1 b8 

1 cO 

1 21 

1 94 

1 7a 

1 el 

1 47 | 

30 I 

ae 

1 14 

1 cO 

1 21 

1 70 

1 a3 

1 d7 

1 a 

1 3d 

1 70 | 


HP-UX Binary File Contents with Real Numbers 


The real number data in an HP-UX binary file is formatted in IEEE-standard, 
64-bit, floating-point notation for real numbers. 

Examples of HP-UX File Access: Binary Integers 

The next data type to be demonstrated in examples will be files of integer 
data. The first program below is a BASIC program that writes some integer 
values into an HP-UX file. 

10 ! RE-STORE "SHARE_INT" 

20 ! 

30 INTEGER N 
40 ! 

50 ! Create ft Assign the output file. 

60 ! 

70 CREATE "INT_DATA",1 

80 ASSIGN Wile TO "INT_DATA";FORMAT OFF ! Treat as "binary" file. 

90 ! 

100 ! Output the integer numbers to the data file 

110 ! 

120 FOR N=-9 TO 240 
130 OUTPUT «File;N 
140 NEXT N 
150 ASSIGN CFile TO * 

160 ! 

170 END 

In this BASIC program, the file INT.DATA is an HP-UX file into which 
this program writes 250 integer numbers. The ASSIGN statement is again 
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performed with FORMAT OFF to specify that the internal data representation 
is to be used (which makes the file an “HP-UX binary” file). 

The next program is an HP-UX C program that reads the data file that the 
above BASIC program wrote. 

tinclude <stdio.h> 
mainO 
{ 

int X; 

short Y[250]; 

FILE *datafile, *fopen(); 

/*** ***/ 

/*** Open file to read data ***/ 

/*** ***/ 

datafile = fopen("/users/workstation/basic/files/INT_DATA", "r"); 
if (datafile == NULL) { 

printf("Can’t open file.\n M ); 
exit(1); 

> 

/*** ***/ 

/*** Get integer data from file and print data ***/ 

/*** ***/ 

fread((char *)Y, sizeof(Y[0]), 250, datafile); 
for (X = 0; X <= 249; X += 1) 
printf("%d\n M ,Y[X]); 
fclose(datafile); 

> 

In this HP-UX C example, the file INT_DATA is the HP-UX binary (or 
untyped) file into which the BASIC program wrote 250 integer numbers. Note 
that the HP-UX C program reads these integers into an array of short with 
the “fread” routine. This data must be handled as type short in C to remain 
compatible with the 16-bit integer format used in BASIC. An HP-UX binary 
file allows more efficient disc-space use than an HP-UX text file, since each 
integer number takes 2 bytes of disc space. An HP-UX binary file is also faster 
because no format-conversion is required. 
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Below is the hex dump of the first 40 bytes of the file “INT.DATA”, which will 
be used to get a better understanding of how BASIC formatted the integer 
number data when it wrote to this HP-UX binary file. 


BYTEI 

+0 

1 +1 

1 +2 

1 +3 

1 +4 

1 +5 

1 +6 

1 +7 

1 +8 

1 +9 1 

0 l 

ff 

1 f 7 

i m 

1 f 8 

1 ff 

1 f 9 

i ff 

1 fa 

i ff 

1 fb I 

10 I 

ff 

1 fc 

i ff 

1 fd 

1 ff 

1 fe 

i ff 

1 ff 

1 0 

1 0 I 


20 I 01 11 01 2 | 01 31 0| 41 01 SI 

30 I 01 61 01 7| 0| 81 01 9| 0| a I 

HP-UX Binary File Contents with INTEGER Values 

INTEGERS in an HP-UX binary file are formatted in 16-bit two’s-complement 
notation. 

Examples of HP-UX File Access: Binary Strings 

The first program below is a BASIC program that writes some strings into an 
HP-UX binary file. 

10 ! RE-STORE "SHARE.STR" 

20 ! 

30 INTEGER N 
40 ! 

50 ! Create ft Assign the output file. 

60 ! 

70 CREATE M STR_DATA M ,1 

80 ASSIGN @File TO "STR.DATA";FORMAT OFF ! Treat as "binary" file. 

90 ! 

100 ! Output the strings to the data file 

110 ! 

120 FOR N=-9 TO 240 

130 OUTPUT GFile;"This is "&TRIM$(VAL$(N))ft" line" 

140 NEXT N 

150 ASSIGN QFile TO * 

160 ! 

170 END 

In this BASIC example, the file STR_DATA is an HP-UX file into which this 
program writes 250 data strings. The ASSIGN statement is again performed 
with FORMAT OFF to specify that the internal data representations are to 
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be used (an “HP-UX binary” file). Each string output to the file has a null 
character, CHR$(0), appended to the end of the string automatically by the 
OUTPUT statement. This null character is used by the HP-UX C program as 
a string-termination character. 

The next program is an HP-UX C program to read the data file that the above 
BASIC program wrote. 

tinclude <stdio.h> 
mainO 
{ 

int I, X; 
char Stmg [40] ; 

FILE ♦datafile, *fopen(); 

/*** ***/ 

/*** Open file to read data ***/ 

/*** ***/ 

datafile = fopen( M /users/workstation/basic/files/STR_DATA M , "r") 5 
if (datafile == NULL) { 
printf("Can’t open file.\n"); 
exit(1); 

> 

/*** ***/ 

/♦♦♦ Get string data from file and print data ***/ 

/*** ***/ 

for (X = 0; X <= 249; X += 1) { 

1 = 0; 

while ((Strng[I] = getc(datafile)) != ’XOOO’) 

I++; 

printf ( M Xs\n" ,Strng); 

} 

fclose(datafile); 

} 

In this HP-UX C example, the file STR_DATA is the HP-UX file into which 
the BASIC program wrote 250 strings. Note that the HP-UX C program reads 
these strings into an “array of char” with the “getc” routine reading each 
character. The “while” loop repeats until a null character has been read by the 
“getc” routine. 
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Below is the hexadecimal dump of the first 60 bytes of the file “STR_DATA”. 
This shows how BASIC formatted the strings in this HP-UX binary file. 


BYTEl 

+0 

i 

+1 

i 

+2 

i 

+3 

i 

+4 

i 

+5 

i 

+6 

i 

+7 

i 

+8 

i 

+9 

0 1 

54 

i 

68 

i 

69 

i 

73 

i 

20 

i 

69 

i 

73 

i 

20 

i 

2d 

i 

39 

10 I 

20 

i 

6c 

i 

69 

i 

6e 

i 

65 

i 

0 

i 

54 

i 

68 

i 

69 

i 

73 

20 I 

20 

i 

69 

i 

73 

i 

20 

i 

2d 

i 

38 

i 

20 

i 

6c 

i 

69 

i 

6e 

30 I 

65 

i 

0 

i 

54 

i 

68 

i 

69 

i 

73 

i 

20 

i 

69 

i 

73 

i 

20 

40 I 

2d 

i 

37 

i 

20 

i 

6c 

i 

69 

i 

6e 

i 

65 

i 

0 

i 

54 

i 

68 

50 I 

69 

i 

73 

i 

20 

i 

69 

i 

73 

i 

20 

i 

2d 

i 

36 

i 

20 

i 

6c 


HP-UX Binary File Contents with Strings 


To help visualize how this data is stored in an HP-UX binary file, the ASCII 
equivalent of this same data is now shown below. 


BYTEl 

+0 

i 

+1 

i 

+2 

i 

+3 

i 

+4 

i 

+5 

i 

+6 

i 

+7 

i 

+8 

i 

+9 

i 






















0 1 

T 

i 

h 

i 

i 

i 

s 

i 


i 

i 

i 

s 

i 


i 

- 

i 

9 

i 

10 I 


i 

1 

i 

i 

i 

n 

i 

e 

1 M NUL M 

i 

T 

i 

h 

i 

i 

i 

s 

i 

20 I 


i 

i 

i 

s 

i 


i 

- 

i 

8 

i 


i 

1 

i 

i 

i 

n 

i 

30 I 

e 

1 M 

NUL" 

i 

T 

i 

h 

i 

i 

i 

s 

i 


i 

i 

i 

s 

i 


i 

40 | 

- 

i 

7 

i 


i 

1 

i 

i 

i 

n 

i 

e 

1 M 

NUL" 

i 

T 

i 

h 

i 

50 I 

i 

i 

s 

i 


i 

i 

i 

s 

i 


i 

- 

i 

6 

i 


i 

1 

i 


ASCII Character Equivalent 


This table shows that each string written by BASIC was terminated by a null 
character. There is no carriage return or line feed. 

Examples of ASCII File Access 

The file types demonstrated so far have been HP-UX files that both BASIC 
and HP-UX can easily access with a native language program. When the file 
type is a ASCII file, it can still be accessed from HP-UX. 

This example writes real numbers into a ASCII file. 
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RE-STORE M SHARE_ASC' 


10 
20 

30 ! Create ft Assign the output file. 

40 ! 

50 CREATE ASCII M ASC_DATA M ,1 

60 ASSIGN CFile TO M ASC_DATA" 

70 ! 

80 ! Output the data to the ASCII file. 

90 ! 

100 FOR N=-9.0 TO 8.5 STEP .07 

110 OUTPUT CFilejN 
120 NEXT N 

130 ASSIGN CFile TO * 

140 ! 

150 END 

The next program is an HP-UX C program to read the data file that the above 
BASIC program wrote. 
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#include <stdio.h> 

#include <math.h> 
main() 

{ 

float Y, Result, rval; 
short I[l]; 
int J, X; 
char Strng[40]; 

FILE *datafile, *fopen(); 

/*** ***/ 

/*** Open file to read data ***/ 

/*** ***/ 

datafile = fopen("/users/workstation/basic/files/ASC_DATA M , "r"); 
if (datafile == NULL) { 
printf("Can’t open file.\n"); 
exit(l); 

> 

/*** ***/ 

/*** Get voltage data from file and print data ***/ 

/*** ***/ 

fseek(datafile, 512, 0); 
for (X = 1; X <= 250; X += 1) { 
fread((char *)I, sizeof(I), 1, datafile); 
rval = I[0]; 

if ((Result = fmod(rval, 2.0)) != 0.0) 

I[0] ++; 

J = 0; 

while (J < I[0]) { 

StmgCJ] = getc(dataf ile) ; 

J++; 

> 

sscanf (Strng, "7,f", &Y) ; 
printf ("7,f\n",Y) ; 

> 

fclose(datafile); 

> 

In this HP-UX C example, the file ASC-DATA is the ASCII file into which the 
BASIC program wrote 250 real values. Note that the HP-UX C program reads 
the 2-byte length header with the “fread” routine, then uses this length number 
to read the same number of characters with the u getc” routine. The u sscanf” 
routine then converts each string back to the real number value with the “%f’ 
conversion specification. This program also requires the “fseek” routine to force 
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the file pointer to skip over the 512-byte header block that BASIC inserts at 
the beginning of the ASCII file. 

Below is the hexadecimal dump of significant portions of the first 560 bytes 
of the file ASC.DATA, which shows how BASIC formatted the data when it 
wrote to this ASCII file. 


BYTEI 

+0 

i 

+1 

i 

+2 

i 

+3 

i 

+4 

i 

+5 

i 

+6 

i 

+7 

i 

+8 

i 

+9 

i 

0 l 

80 

i 

0 

i 

48 

i 

46 

i 

53 

i 

4c 

i 

49 

i 

46 

i 

0 

i 

0 

i 

10 I 

0 

i 

1 

i 

10 

i 

0 

i 

0 

i 

0 

i 

0 

i 

0 

i 

0 

i 

1 

i 

20 I 

0 

i 

0 

i 

0 

i 

0 

i 

0 

i 

0 

i 

0 

i 

1 

i 

0 

i 

0 

i 

30 I 

0 

i 

1 

i 

0 

i 

0 

i 

0 

i 

3 

i 

11 

i 

11 

i 

11 

i 

11 

i 

40 I 

11 

i 

11 

i 

0 

i 

0 

i 

0 

i 

0 

i 

0 

i 

0 

i 

0 

i 

0 

i 

240 I 

0 

i 

0 

i 

0 

i 

0 

i 

0 

i 

0 

i 

0 

i 

0 

i 

11 

i 

11 

i 

250 I 

11 

i 

11 

i 

11 

i 

11 

i 

0 

i 

0 

i 

57 

i 

53 

i 

5f 

i 

46 

i 

260 I 

49 

i 

4c 

i 

45 

i 

20 

i 

20 

i 

20 

i 

0 

i 

1 

i 

0 

i 

0 

i 

270 I 

0 

i 

2 

i 

0 

i 

0 

i 

0 

i 

3 

i 

86 

i 

12 

i 

5 

i 

15 

i 

280 I 

54 

i 

16 

i 

80 

i 

1 

i 

0 

i 

0 

i 

0 

i 

0 

i 

0 

i 

0 

i 

290 I 

0 

i 

0 

i 

0 

i 

0 

i 

0 

i 

0 

i 

0 

i 

0 

i 

ff 

i 

ff 

i 

510 I 

0 

i 

0 

i 

0 

i 

2 

i 

2d 

i 

39 

i 

0 

i 

5 

i 

2d 

i 

38 

i 

520 1 

2e 

i 

39 

i 

33 

i 

20 

i 

0 

i 

5 

i 

2d 

i 

38 

i 

2e 

i 

38 

i 

530 I 

36 

i 

20 

i 

0 

i 

5 

i 

2d 

i 

38 

i 

2e 

i 

37 

i 

39 

i 

20 

i 

540 I 

0 

i 

5 

i 

2d 

i 

38 

i 

2e 

i 

37 

i 

32 

i 

20 

i 

0 

i 

5 

i 

550 I 

2d 

i 

38 

i 

2e 

i 

36 

i 

35 

i 

20 

i 

0 

i 

5 

i 

2d 

i 

38 

i 


ASCII File Contents with Real Values 
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The ASCII equivalent of this same data is shown below. 


BYTEl +0 

1 +1 

1 +2 

1 +3 

1 +4 

1 +5 

1 +6 

1 +7 

1 +8 

1 +9 

0 

180hex 

1"NUL" 

1 H 

1 F 

1 s 

1 L 

i i 

1 F 

1"HUL" 

1"HUL" 

10 

1"HUL" 

1"S0H" 

|"DLE" 

1 "HUL" 

1"HUL" 

1"HUL" 

1"HUL" 

1"HUL" 

1"HUL" 

1"S0H" 

20 

1"HUL" 

1"HUL" 

1"HUL" 

1"HUL" 

1"HUL" 

1"HUL" 

1"HUL" 

1"S0H" 

1"HUL" 

1"HUL" 

30 

1"HUL" 

1"SOL" 

1"HUL" 

1"HUL" 

1 "HUL" 

1"EXT" 

1"DCl" 

1"DCl" 

1"DCl" 

1"DCl" 

40 

1"DC1" 

1"DCl" 

1"MUL" 

1"HUL" 

1"HUL" 

1"HUL" 

1"HUL" 

1"HUL" 

1"HUL" 

1"HUL" 


240 

1"HUL" 

1"HUL" 

1"HUL" 

1"HUL" 

1"HUL" 

1"HUL" 

1"HUL" 

1"HUL" 

1"DCl" 

1"DCl" 

250 

1"DCl" 

1"DCl" 

1"DCl" 

1"DCl" 

1"HUL" 

1"HUL" 

1 V 

1 S 

1 _ 

1 F 

260 

1 I 

1 L 

1 E 

1 

1 

1 

1"HUL" 

1"S0H" 

1"HUL" 

1"HUL" 

270 

1"HUL" 

1"STX" 

1"HUL" 

1"HUL" 

1"HUL" 

1"EXT" 

186hex 

1"DC2" 

1"EHQ" 

1"HAK" 

280 

1 T 

1"SYHC" 

180hex 

1"S0H" 

1"HUL" 

I"HUL" 

1"HUL" 

1"HUL" 

1"HUL" 

1"HUL" 

290 

1"HUL" 

1"HUL" 

1"HUL" 

I"HUL" 

1"HUL" 

1"HUL" 

1"HUL" 

1"HUL" 

iFFhex 

IFFhex 

510 

1"HUL" 

1"HUL" 

1"HUL" 

1"STX" 


1 9 

1"HUL" 

1"EHQ" 


1 8 

520 

1 . 

1 9 

1 3 

1 

1"HUL" 

1"EHQ" 

1 - 

1 8 


1 8 

530 

1 6 

1 

1"HUL" 

1"EHQ" 

I 

1 8 

1 . 

1 7 

1 9 

1 

540 

1"HUL" 

1"EHQ" 

1 - 

1 8 


1 7 

1 2 

1 

1"HUL" 

1"EHQ" 

550 

1 - 

1 8 

1 . 

1 6 

1 5 

1 

1"HUL" 

1"EHQ" 

I 

1 8 


ASCII Character Equivalent 


This table shows the 512 byte header block that BASIC puts at the beginning 
of a LIF ASCII file on HFS discs. The portions of this block not shown in the 
table contains all zeros. This table also shows the 2-byte length header at the 
beginning of each string. Note that the strings have no added termination 
characters. 

HP-UX File Dump Utility 

When debugging problems that can arise from BASIC and HP-UX sharing 
data files, it may be necessary to look at the contents of data within the file. 
This program is an HP-UX C program to read the contents of a file and display 
the contents in hexadecimal format. 
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♦include <stdio.h> 
main(argc, argv) 
int argc; 
char *argv[] ; 

{ 

int X, Y, values[20], start, end; 

FILE *datafile, *fopen(); 

printf("Contents of */,s\n" ,argv[l] ) ; 

/*** ***/ 

/*** Open file to read data ***/ 

/*** ***/ 

datafile * fopen(argv[l], "r"); 
if (datafile == NULL) { 
printf("Can’t open file %s\n" ,argv[l] ); 
exit(1); 

> 

/*** ***/ 

/*** Get data from file and print data ***/ 

/*** ***/ 

sscanf (argv[2] , "7,d" , ftstart) ; 
sscanf(argv[3], "%d", ftend); 
fseek(datafile, start, 0); 
printf("BYTE I"); 
for (X = 0; X <= 9; X += 1) { 
printf ("7,4+d I " , X) ; 

} 

printf ("\n") ; 

for (X = 0; X <= 3; X += 1) { 
printf("-"); 

} 

printf("+"); 

for (Y = 0; Y <= 9; Y += 1) { 
for (X = 0; X <= 5; X += 1) { 
printf("-"); 

> 

printf("+"); 

> 

printf("\n"); 

for (Y * start; Y <= end; Y +=10) { 
printf ("7.3d I " ,Y) ; 
for (X = 0; X <= 9; X += 1) { 
values[X] = getc(datafile); 
values[X] = values[X] & 0377; 
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printf ("*/.4x I M , values [X] ) ; 

} 

printf( M \n M ); 

} 

fclose(datafile); 


Once this program has been compiled, it is executed by the following syntax: 
prog-name file-name start end 
in which: 

prog-name is the name of the compiled program that is to be executed 
file-name is the file to dump 

start is the starting byte at which to begin the dump 

end is the last byte of the dump 


Porting LIF Files to SRM 

This section summarizes ways you can modify existing programs that use LIF 

discs to allow those programs to access the SRM system. 

When modifying programs to access SRM-controlled mass storage device(s), 

you should be aware that: 

■ LIF and SRM mass storage file specifiers may differ and string variable 
names that contain file specifiers may need corresponding modification. 

■ References to mass storage volume specifiers (msvs) throughout the program 
may have to be altered. 

■ Allowances may have to be made for directory path specification. 

■ LIF protect codes may differ from SRM passwords. The syntax for 
protecting SRM files is different from that used for LIF files. 
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SRM File Specifiers 

Composition of SRM File Names 

All file names for local mass storage are one to 10 characters long, while SRM 
file names contain one to 16 characters. Remote file names can contain the 
period character ( . ) while local files cannot. If file name compatibility 
between resources is required, use 10 or fewer characters and do not use periods 
within SRM file names. 

SRM File and Mass Storage Device Specification in String Variables 

Modifying programs for use with SRM resources generally requires changing 
the value, and often the length, of the string variables used to specify files 
and mass storage devices. The statements that assign the actual values to the 
string variables may have to be modified individually. 

Some programs use one string variable for the entire file specifier. For instance: 
100 DIM File_specifier$[32] 

110 LINPUT "Enter file specifier", File_specifier$ 

120 ON ERROR GOTO 110 ! Try again if improper specifier. 

130 ASSIGN DPath TO File.specifier$ 

140 OFF ERROR 

If one variable is used for all file specifiers (as in the preceding example), only 
the length of the variable needs to be changed to allow for the additional 
characters allowed in SRM file specifiers. 

The maximum number of characters that can be entered into a string variable 
from the keyboard in one operation is a good size for a file specifier variable. 

■ Series 200 Models 216, 220, 226 and 236 allow up to 160 characters. Series 
300 computers with medium-resolution displays also allow 160 characters. 

■ Model 237 allows 256 characters. Series 300 computers with high-resolution 
displays also allow 256 characters. 

Thus, the length of File.specif ier$ in the preceding example’s DIM 
statement would be changed from 32 to 160 or 256, accordingly. 

Note that the system mass storage device (the current MASS STORAGE IS 
device) will be accessed if no msvs is explicitly specified. 
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SRM Mass Storage Volume Specification 

Some programs use separate variables for the file name and volume specifiers. 
For example: 

ASSIGN CPath TO Filename$&Msvs$ 

If so, both variables may have to be dimensioned to greater lengths. Allowing 
34 characters for the file name variable accommodates a 16-character file 
name, a 16-character password, and the “<” and “>” password delimiters (for 
example, “ASCDEFGHIJ123456<1234567890123456>”). The SRM volume 
specifier may occupy up to 54 characters. 

Other programs may use MASS STORAGE IS statements throughout the 
program instead of including the msvs in each file specifier. For instance: 

MASS STORAGE IS Left_drive$ 

ASSIGN CFile TO File_name$ 

Unless variable(s) are used to specify the msvs and each variable is assigned a 
value in only one place, you may have to modify each MASS STORAGE IS 
statement to specify the desired SRM volume. 

Allowing for SRM Directory Paths 

Suppose the following program needs to be modified to include a SRM file’s 
directory path. 

100 DIM Filenames[14],Msvs$[20] 

500 Filename$="SLIDES" 

510 Msvs$=":HP9895,700" 


1000 ASSIGN 8File TO FilenameS&MsvsS 
1010 OUTPUT 8File;Data(*) 

1020 ASSIGN SFile TO * 


2000 ASSIGN flFile TO Filename$&Msvs$ 
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2010 OUTPUT «File;Data(*) 

2020 ASSIGN CFile TO * 

In the next example, it is probably easiest to add another string variable for 
the (optional) directory path name. For example: 

100 DIM Dir_path$[160] ,File_name$[80] , Vol_spec$[80] 


500 Dir_path$="FRED/DATA_FILES/" 
510 File_name$="SLIDES" 

520 Vol_spec$=":REMOTE 21,1" 


1000 ASSIGN CFile TO Dir_path$AFile_name$ftVol_spec$ 

1010 OUTPUT CFile;Data(*) 

1020 ASSIGN CFile TO * 

If the Dir_path$ variable is null, the statement looks exactly like it did before 
the modification. If the Vol_spec$ variable is null, the current mass storage 
device is accessed. The only difference is in the allowable length of the string 
variables. 

SRM Passwords vs. LIF Protect Codes 

The PROTECT statement syntax for SRM files is different from the syntax for 
LIF files. Depending on the type of mass storage that is being used, you can 
use either of the following to decide which syntax will be used: 

1. Try the non-SRM syntax with an ON ERROR statement enabled. If an 
error occurs, see if it indicates that the mass storage device is an SRM. An 
Error 1 occurs when the following statement is executed on an SRM file: 

PROTECT file specifier,protect code 

2. If the program uses a string to store the volume specifier, check for a 
non-zero value of PQS(Vol_spec$, n REMQTE M ). This alternative is easier to 
implement than alternative 1 but will not work if the program accesses the 
default device when Vol_spec$ is empty. 
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If the program looks for a password error (Error 62) at ASSIGN time, the 
program may have to be modified because the system may not detect the 
password error until an ENTER ©Path or OUTPUT @Path is attempted. 


Copying Item-by-ltem Using ENTER and OUTPUT 

You may copy a file from LIF to SRM mass storage one item at a time, as 
illustrated in the programs that follow. These programs use the ENTER and 
OUTPUT statements to copy data item-by-item from a LIF BDAT file to an 
SRM BDAT file. 

The first program creates and fills a BDAT file named BDAT.FILE. 

10 CREATE BDAT "BDAT_FILE:INTERNAL",10 

20 ASSIGN QLocal TO ”BDAT_FILE:INTERNAL" 

30 ! 

40 FOR Item=l TO 50 

50 OUTPUT CLocal;"String data item" 

60 NEXT Item 

70 ! 

80 ASSIGN CLocal TO * 

90 END 

The second program copies the contents of BDAT.FILE item-by-item into a file 
(also called BDAT.FILE) in the SRM directory named General (shown in the 
previous illustration). 

100 DIM String.item$[20] 

110 CREATE BDAT ’’PRO JECTS/General/BDAT.FILE:REMOTE”,10 

120 ASSIGN CLocal TO '’BDAT.FILE:INTERNAL M 

130 ASSIGN CRemote TO ”PR0JECTS/General/BDAT FILE:REMOTE” 

140 ! 

150 FOR Item=l TO 50 

160 ENTER C Local;String_item$ 

170 OUTPUT CRemote;String.item$ 

180 NEXT Item 

190 ! 

200 ASSIGN CLocal TO * 

210 ASSIGN CRemote TO * 

220 END 
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Accessing Files Created on 
Non-Series-200/300 SRM Workstations 

Regardless of the kind of the computer or language system, ASCII files can be 
shared among all workstations on the SRM. 

This example shows how you can access an ASCII file named Prog.x, which 
was created on an HP 9845 with the SAVE ASCII statement. 

In this example, Prog_x is in an HP 9845 workstation user s directory called 
COMMON. COMMON is located in the directory W0RK.45, which is at the root of the 
SRM directory structure. The password mypass protects the READ capability 
on W0RK.45. All access capabilities on COMMON are public. 

To access Prog.x on a Series 200/300 Workstation, you would type: 

GET "W0RK_45<mypass>/C0MM0N/Prog_x:REMOTE" 

or 

GET M /V0RK_45<mypass>/C0MM0N/Prog_x" 

The system would then put Prog.x into your workstation. Keep in mind that, 
with GET, any lines containing syntax that is invalid for Series 200/300 BASIC 
will be stored as commented program lines (such as 100 ! BEEPER 10,10 ). 
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Introduction 


There are three implementations of HP BASIC: 


BASIC/WS 

BASIC/DOS 


BASIC/UX 


The Workstation implementation, which is a combined 
language and operating system that runs on HP 9000 Series 
200/300 computers. 

The DOS implementation, which is a card that plugs into 
an HP Vectra or other PC-compatible computer. This 
implementation is essentially a Series 200 computer on a card 
that plugs into a PC. 

The HP-UX implementation, which is essentially the BASIC 
interpreter and part of the BASIC Workstation operating 
system that runs as a set of processes “on top of’ the HP-UX 
operating system. 


This chapter describes the differences and enhancements that BASIC/UX 
provides to the BASIC/WS implementation. (It does not describe the 
differences between BASIC/DOS and BASIC/WS. See the documentation 
supplied with the HP 82321 BASIC Language Processor card for that 
information.) 
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Prerequisites to Reading this Chapter 

In order to understand the information in this chapter, you should: 

■ Already be familiar with the BASIC/WS implementation of HP BASIC 
(otherwise, this “delta” information will not make much sense to you). 

■ Have a copy of the BASIC/UX manual set available (so you can look up 
some of the details of the brief descriptions given here). 


Compatibility Between BASIC/UX and BASIC/WS 

The BASIC/UX implementation is highly compatible with the BASIC/WS 
implementation. Nearly all programs written for BASIC/WS will run 
(with minor modifications) on the BASIC/UX system. However, because 
BASIC/WS has its own operating system and BASIC/UX runs on the HP-UX 
operating system: 

■ Some BASIC/WS keywords do not work on BASIC/UX. 

■ Some BASIC/WS keywords work differently on BASIC/UX. 

■ BASIC/UX has also added new keywords to the BASIC/WS keyword set. 

This chapter provides a brief summary of these differences and enhancements. 
For a detailed description of a particular difference or enhancement, refer to the 
BASIC manual specified in the table entry (in this chapter) that describes that 
feature. 

Are You Porting BASIC/WS Programs to BASIC/UX ? 

One of the main benefits of reading this chapter is that it will help you 
determine what will be required to port existing BASIC/WS programs to run 
on the BASIC/UX system. If you are porting existing software, you should at 
least scan this chapter before reading the chapter called “Porting BASIC/WS 
Programs to BASIC/UX”. 
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Summary of BASIC/UX Differences 

The following tables list the differences between BASIC/UX and BASIC/WS 
keywords. 


Legend for Subsequent Tables 

After each brief keyword description, the table gives a manual name and 
chapter number to help you locate more information on that particular 
keyword. Here are the acronyms used in the tables to specify BASIC manuals. 

BASIC/UX Graphics Techniques 

Installing and Maintaining the BASIC/UX System 

BASIC/UX Interfacing Techniques 

BASIC/UX Language Reference 

BASIC/UX Programming Techniques 

Using the BASIC/UX System 


GT 

IM 

IT 

LR 

PT 

UB 
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Keyword/Feature 

BASIC/WS 

Description 

BASIC/UX 

Description 

For More 

Info 

ALPHA ON and 
ALPHA OFF 

Turns the 

alphanumeric display 
on or off. 

On a console, these 
keywords function the same 
as for BASIC/WS. However, 
on a terminal or in X 
Windows these keywords are 
no-ops. The reason for this 
is on terminals alpha and 
graphics are separated and 
cannot be merged and in X 
Windows alpha and graphics 
are merged and cannot be 
separated. 

LR 

Keyword 

Dictionary 

ASSIGN 

Assigns an I/O path 
name and attributes 
to a device, group 
of devices, a mass 
storage file, or a 
buffer. 

Extended to allow piping 
to/from HP-UX commands 
(such as M | lp") and to 
allow output to windows. 

IT 

Chapter 3 

CAT 

Lists the contents 
of a mass storage 
directory or provides 
information on a 
specified PROG file. 

For HFS directories, the 
device selector, unit, and 
volume numbers normally 
found in the first line 
are not displayed, and 
the device type is shown 
as HFS. Also, CAT on 
BASIC/UX recognizes 
additional file types which 
may be found on HFS 
volumes (e.g., PIPE). CAT 
has not changed for LIF or 
SRM directories. 

LR 

Keyword 

Dictionary 
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Keyword/Feature 

BASIC/WS 

Description 

BASIC/UX 

Description 

For More 

Info 

CONTROL CRT, 18 

Sets the alpha 
write-enable mask to 
a bit pattern. 

Same as the description 
for the keywords ALPHA 
ON and ALPHA OFF. 

IT 

Chapter 10 

CONTROL CRT,21 

Switches between 
Series 200 CRT 
compatibility 
mode and native 
bit-mapped mode. 

Not supported. 

IT 

Chapter 10 

CONTROL KBD,11 

Sets the knob pulse 
mode. 

KNB2_0 binary 
functionality is not 
supported on BASIC/UX. 

IT 

Chapter 11 

CONTROL 32 

This pseudo select 
code is used to turn 
on and off parity 
checking, system 
(memory) cache, 
and processor 
(instruction) cache. 

Control registers 0,1, and 

3 are not supported on 
pseudo select code 32; 
however, all of its status 
registers are supported. 

PT 

Chapter 13 

CREATE 

Creates a new file. 

The default permission 
for files and directories 
created on HFS volumes 
may be modified using 
the HP-UX umask (1) 
command. 

HP-UX 

Language 

Reference 
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Keyword/Feature 

BASIC/WS 

Description 

BASIC/UX 

Description 

For More 

Info 

Datacomm and 

Serial Interfaces: 

■ CONTROL 
Registers 

■ STATUS Registers 

Supported as 
stated in the 

BASIC Interfacing 
Techniques manual. 

Some registers are 
not supported or 
have slightly different 
definitions, some registers 
have been added, and 
READIO and WRITEIO 
are not supported. 

Also, the HP 98642A 
4-Channel Multiplexer 
has been added as a new 
datacomm interface card 
that is supported by 
BASIC/UX. 

IT 

Chapter 13 
and 

Chapter 14 

DUMP ALPHA 
DUMP GRAPHICS 

Copies the output of 
the alpha or graphics 
display to a printing 
device. 

Extended to support 
output to windows and 
named or unnamed pipes. 
Note that windows can 
only receive alpha output. 
Also, DUMP GRAPHICS 
is not supported on 
terminals. 

GT 

Chapter 3 

DUMP DEVICE IS 

Specifies which 
device receives the 
data when either 
DUMP ALPHA or 
DUMP GRAPHICS 
is executed without a 
device selector. 

Extended to support 
output to windows and 
named or unnamed pipes. 
Note that windows can 
only receive alpha output. 

GT 

Chapter 3 
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Keyword/Feature 

BASIC/WS 

Description 

BASIC/UX 

Description 

For More 

Info 

ENTER 

Used to input data 
from a specified 
source and assign the 
value(s) entered to 
variable(s). 

Extended to support 
input from a named or 
unnamed pipe. 

IT 

Chapter 5 

ERRM$ 

ERRN 

ERRM$ returns the 
text of the error 
message associated 
with the most recent 
program execution 
error. ERRN returns 
the number of the 
most recent error. 

BASIC/UX provides new 
errors in the range 186 
to 198 and 810 to 867. 

(All error messages are 
listed in the appendices 
of the BASIC Language 
Reference and BASIC 
Condensed Reference.) 

PT 

Chapter 11 

GESCAPE CRT, 7 

Sets the graphics 
write- and 

display-enable masks. 

Not supported in windows 
or terminals. 

GT 

Chapter 2 

GLOAD 

Loads the contents of 
an INTEGER array 
into a frame buffer. 

Not supported on 
terminals. 

GT 

Chapter 2 

GRAPHICS 

INPUT IS 

Assigns the graphics 
input device for 
DIGITIZE, READ 
LOCATOR, etc. 

Works the same as with 
BASIC/WS on a console. 

In a window environment, 
use the keyword SET 

HIL MASK to select 
graphics input devices 
not used by the window 
manager. Terminals are 
restricted to input from 
the keyboard. 

LR 

Keyword 

Dictionary 





BASIC/UX Differences 22-7 
and Enhancements 















Keyword/Feature 

BASIC/WS 

Description 

BASIC/UX 

Description 

For More 

Info 

GRAPHICS ON 
GRAPHICS OFF 

Turns the graphics 
display on or off. 

Same as the description 
for the keywords ALPHA 
ON and ALPHA OFF. 

LR 

Keyword 

Dictionary 

GSTORE 

Stores the contents of 
the frame buffer into 
an INTEGER array. 

Not supported on 
terminals. 

GT 

Chapter 2 

HFS Formatted 

Discs 

Requires that HFS 
discs be connected to 
the system to access 
them. 

Requires that all HFS 
discs be “mounted” 
before they can be 
accessed. This allows file 
buffering to be performed, 
which greatly improves 
performance. Also note 
that with BASIC/UX, all 
HFS volumes are joined 
into a single hierarchy (by 
the HP-UX operating 
system). In addition, 
STATUS register 2 is not 
supported for an I/O path 
name assigned to a file on 
an HFS volume. 

UB 

Chapter 5 
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Keyword/Feature 

BASIC/WS 

Description 

BASIC/UX 

Description 

For More 

Info 

HP-HIL Commands: 

IDD 

RNM 

EXD 

RST 

RSC 

These HP-HIL 
commands work as 
stated in Appendix 

A of the BASIC 

Workstation 

Interfacing 

Techniques manual. 

Since BASIC/UX cannot 
determine the number 
of bytes in a packet of 
information returned 
when you execute these 
commands, it uses the 
null byte as a packet 
terminator. This means 
that it will return up to 
the maximum number of 
bytes in a packet and 
ignore all trailing null 
bytes. 

IT 

Appendix 

INITIALIZE 

Prepares (formats) 
mass storage media 
for use by the 
computer. 

Works the same as with 
BASIC/WS; however, 
only an unmounted disk 
may be INITIALIZED. 

IM 

Chapter 2 

Interfaces not 
supported on 
BASIC/UX: 

■ BCD 

■ EPROM 

■ Powerfail 

■ Bubble Memory 

Supported as stated 
in the BASIC/WS 
documentation. 

These interfaces are not 
supported on BASIC/UX; 
however, you can gain 
access to their hardware 
by using the keywords 
READIO and WRITEIO. 

Not 

available. 

KNOBX 

KNOBY 

Return the 
net number of 
horizontal knob 
pulses (KNOBX) or 
vertical knob pulses 
(KNOBY). 

Use BASIC/WS 3.0 
definitions (and the 

KNB2_0 binary/definition 
is not supported). 

IT 

Chapter 11 
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Keyword/Feature 

BASIC/WS 

Description 

BASIC/UX 

Description 

For More 

Info 

LIST 

Lists the program 
currently in memory, 
and then shows the 
amount of memory 
available for program 
storage. 

Lists the program, and 
then shows the sum of the 
memory available for 
program storage, stack, 
and COM. 

UB 

Chapter 2 

LIST BIN 

Lists the name and 
version number of 
each binary currently 
in memory. 

Functions the same 
as with BASIC/WS; 
however, the LIST BIN 
command will list all 
BASIC/WS binaries (the 
display will not vary since 
all binaries are always 
loaded). 

IM 

Chapter 5 

LOAD BIN 

Loads binaries into 
memory. 

Not supported by 
BASIC/UX, because all 
BASIC/WS binaries are 
part of the BASIC/UX 
system. 

IM 

Chapter 5 

ON/OFF CYCLE 
ON/OFF DELAY 
ON/OFF TIME 
ON/OFF TIMEOUT 

Enable/cancel 

event-initiated 

branches. 

Work the same as with 
BASIC/WS; however, 
clock/timer resolution is 

20 milliseconds (vs. 10 
for BASIC/WS). A child 
process of BASIC/UX is 
spawned to handle timers. 

PT 

Chapter 9 

OUTPUT 

Outputs items to a 
specified destination 
(device, I/O path, or 
string variable). 

Works the same as with 
BASIC/WS; however, 
you can also output to 
a window and named or 
unnamed pipe. 

IT 

Chapter 4 
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Keyword/Feature 

BASIC/WS 

Description 

BASIC/UX 

Description 

For More 

Info 

Memory Volume 

BASIC/WS allows 
you to create a 
memory volume in 
your computer’s 
random access 
memory (RAM). 

This provides a fast 
means for storing and 
retrieving files. 

BASIC/UX will not 
support TRANSFERS to 
memory volumes. Also, 
BASIC/UX only supports 
LIF formatted memory 
volumes. It does not 
support HFS formatted 
memory volumes. 

IM 

Chapter 8 

msvs 

(mass storage 
volume specifier) 

Allows you to specify 
mass storage devices 
other than the 
default volume. 

Allows mapping of a 
volume specifier to an 
HP-UX directory name 
by using the specifier 

DISK in your BASIC/UX 
configuration file 
(.rmbrc). Also when the 
device type is HFS, the 
device selector is ignored 
unless it is mapped. 

Finally, M :HFS M may 
be used to refer to the 
current working directory 
(the HFS directory that 
you had most recently 
moved to using the MASS 
STORAGE IS command). 

IM 

Chapter 5 

PASS CONTROL 

Passes Active 
Controller capability 
to a specified HP-IB 
device. 

Passing control to an 
interface connected to a 
swap device or a mounted 
file system is not allowed. 

IT 

Chapter 12 
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Keyword / Feature 

BASIC/WS 

Description 

BASIC/UX 

Description 

For More 

Info 

PLOTTER IS 

PRINTALL IS 
PRINTER IS 

PLOTTER IS selects 
the system plotting 
device. 

PRINTALL IS selects 
a printing device 
for error messages, 
and PRINTER IS 
specifies the default 
system printing 
device (for PRINT, 
CAT, etc.). 

These statements have 
been extended to allow: 

■ piping of output to an 
HP-UX command (for 
instance, to a spooler 
such as M 1 pit"). 

■ redirection of output to 
a window. 

Also, PRINTALL IS has 
been extended to include 
files. 

GT 

Chapter 3 
and 

PT 

Chapter 8 

PRINT LABEL 

Gives a name to a 
mass storage volume. 

Not supported on HFS 
volumes. 

LR 

Keyword 

Dictionary 

READ LABEL 

Reads a volume label 
into a string variable. 

Not supported on HFS 
volumes. 

LR 

Keyword 

Dictionary 

RE-SAVE 

Creates an ASCII file 
and copies program 
lines as strings into 
that file. 

BASIC/UX will create an 
HP-UX type file instead 
of an ASCII file when 
saving a program on an 
HFS volume. 

LR 

Keyword 

Dictionary 

“Run Light” and 
Other Activity 
Indicators 

An asterisk (*) 
and other textual 
messages are shown 
in the lower, 
right-hand corner of 
the screen. 

BASIC/UX provides: 

■ No Run Light indicator 
(this is on if KEY 
LABELS is off); 

■ A new activity 
indicator (Execute). 

UB 

Chapter 1 
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Keyword/Feature 

BASIC/WS 

Description 

BASIC/UX 

Description 

For More 

Info 

SAVE 

Creates an ASCII file 

and copies program 
lines as strings into 
that file. 

BASIC/UX will create an 
HP-UX type file instead 
of an ASCII file when 
saving a program on an 
HFS volume. 

US 

Chapter 6 

SC 

Returns the interface 
select code associated 
with an I/O path 
name. 

Not supported for an I/O 
path name assigned to a 
file on an HFS volume. 
Also, it is not supported 
for HP-UX pipes. 

IT 

Chapter 6 

SCRATCH BIN 

Clears what 

SCRATCH A does, 
plus it clears all 
binaries except the 
CRT driver for the 
CRT in use. 

All binaries are 
permanently loaded 
and therefore are 
non-scratch able. 

UB 

Chapter 2 

SEPARATE ALPHA 

FROM GRAPHICS 

Used to simulate the 
separate alpha and 
graphics rasters of 
Series 200 displays. 

Same as the description 
for the keywords ALPHA 
ON and ALPHA OFF. 

GT 

Chapter 2 

SET ALPHA 

MASK 

Sets the alpha 
write-enable mask to 
a bit pattern 

Same as the description 
ibr the keywords ALPHA 
ON and ALPHA OFF. 

GT 

Chapter 2 

SET DISPLAY 

MASK 

Sets the display 
write-enable mask to 
a bit pattern. 

Same as the description 
ibr the keywords ALPHA 
ON and ALPHA OFF. 

GT 

Chapter 2 
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Keyword / Feature 

BASIC/WS 

Description 

BASIC/UX 

Description 

For More 

Info 

SET TIME 

Resets the 

time-of-day given by 
the real-time clock. 

Affects the “local” 
BASIC/UX clock value 
only (HP-UX system 
time and date will not 
change). It also allows 
re-synchronization with 
HP-UX time. 

PT 

Chapter 9 

SET TIMEDATE 

Resets the absolute 
seconds (time and 
date) given by the 
real-time clock. 

Affects the “local” 
BASIC/UX clock value 
only (HP-UX system 
time and date will not 
change). It also allows 
re-synchronization with 
HP-UX time. 

PT 

Chapter 9 

SRM Interface 

Provides access to the 
HP Shared Resource 
Manager. 

BASIC/UX only supports 
one SRM interface card 
per system. Also, the 
semantics for LOCK are 
different if more than 
one BASIC/UX process 
is running on the same 
system. Finally, support 
is only provided for SRM 
STATUS registers 3 and 

6. 

PT 

Chapter 7 

STATUS and 
CONTROL 

Registers: 

■ Datacomm 

■ RS-232 

Supported as 
described in the 
BASIC Interfacing 
Techniques manual. 

Some registers are not 
supported or have slightly 
different definitions. 

IT 

Chapter 13 
and 

Chapter 14 
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Keyword/Feature 

BASIC/WS 

Description 

BASIC/UX 

Description 

For More 

Info 

STORE SYSTEM 

Stores the 

BASIC/WS operating 
system and all 
binaries currently in 
memory. 

Not supported on 
BASIC/UX (not needed, 
since there are no 
separate binaries). 

IM 

Chapter 5 

SYSBOOT 

Returns control 
to the BOOT 

ROM to restart the 
system selection and 
configuration process. 

Not supported on 
BASIC/UX. 

IM 

Chapter 5 

SYSTEMS 

(“AVAILABLE 

MEMORY”) 

Returns the amount 
of memory available 
for program storage. 

Returns the sum of the 
memory available for 
program storage, stack, 
and COM. 

UB 

Chapter 3 

SYSTEMS 

(“MASS 

MEMORY”) 

Returns 

X000YZ0000000000 

where: 

X = Number of 
internal disk 
drives; 

Y = Number of 
initialized 
EPROM cards; 

Z = Number of 

bubble memory 
cards. 

(If Y or Z exceed 9, 

an asterisk appears.) 

Always returns 
0000000000000000. 

UB 

Chapter 3 
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Keyword/Feature 

BASIC/WS 

Description 

BASIC/UX 

Description 

For More 

Info 

SYSTEMS 

(“MASS 

STORAGE 

IS”) 

Returns the mass 
storage unit specifier 
of the current MASS 
STORAGE IS device 
as it appears in the 
CAT heading. 

For HFS volumes, 
the device selector, 
unit, and volume 
numbers are not 
shown. For LIF and 
SRM volumes, it has 
not changed. 

us 

Chapter 5 

SYSTEMS 

(“SERIAL NUMBER”) 

Returns one of the 
following: 

■ Bytes 4-14 of an ID 
PROM (if present); 

■ an encoded serial 
number from an 
HP-HIL ID module 
(if present); 

otherwise, it returns 
the null string. 

Returns an encoded 
serial number from an 
HP-HIL ID module 
(if present); 

(ID PROMs are only 
available with Series 
200 computers); 

otherwise, it returns 
the null string. 

UB 

Chapter 3 

TIMEDATE 

Returns the current 
value of the real-time 
clock. 

Works the same as 
with BASIC/WS; 
however, resolution 
is limited to 

20 milliseconds 
(vs. 10 ms with 
BASIC/WS). 

PT 

Chapter 9 
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Keyword/Feature 

BASIC/WS 

Description 

BASIC/UX 

Description 

For More 

Info 

TIMEZONE IS 

Specifies the offset 
from Greenwich Mean 
Time, providing 
compatibility with 
HP-UX time stamps 
on files when 
switching back and 
forth between the 
BASIC and HP-UX 
systems. 

Works the same as on 
BASIC/WS; however, 
when used without a 
parameter the time zone 
is resynchronized with the 
HP-UX time zone. 

PT 

Chapter 9 

TRANSFER 

Initiates unformatted 
I/O transfers, which 
can take place 
concurrently with 
continued program 
execution. 

Supports BASIC/WS 

TRANSFER-related 

statements: 

■ Memory-mapped I/O is 
selected if burst I/O is 
associated with an I/O 
path name. 

■ Concurrent inbound 
outbound TRANSFERS 
are not permitted on an 
RS-232 interface. 

■ Runs as a separate 
process. 

TRANSFER is only 
supported for HFS and 
not for SRM, LIF, or 
MEMORY volumes. 

IT 

Chapter 9 
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K ey word/Feature 

BASIC/WS 

Description 

BASIC/UX 

Description 

For More 

Info 

WAIT 

Causes the computer 
to wait approximately 
the number of 
seconds specified 
before executing the 
next statement. 

Works the same as on 
BASIC/WS; however, 
resolution is load 
dependent, but generally 

60 milliseconds (vs. 10 ms 
on BASIC/WS). 

PT 

Chapter 3 


BASIC/UX Mass Storage Differences 

This section covers mass storage differences between BASIC/WS and 
BASIC/UX. Topics covered are: 

■ Maximum Number of Open HFS Files 

■ Locking SRM Files 

■ Leaving SRM Files Open 

■ SRM Security 

■ Using a Single SRM Interface Card with BASIC/UX 

■ Accessing LIF Media by a Single User 

Maximum Number of Open HFS Files 

The HP-UX operating system imposes a limit on the maximum number of file 
descriptors that each process may use at any time (currently 60). BASIC/UX 
generally uses at least 10 of these internally, plus one for each device in use. 
Any time an HFS file is opened, another file descriptor is put into use until the 
file is closed. Note that opening a LIF or SRM file does not require the use of 
a file descriptor. If the maximum number of open files is reached, then some 
files must be closed. This may be done by executing ASSIGN TO *, pressing the 
[Reset 1 key, or executing SCRATCH A. 

Locking SRM Files 

BASIC/UX allows several instances of HP BASIC to be run on the same 
system. However, the SRM server assumes that each process is running on a 
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different system. Because of this, the semantics of LOCK are different if more 
than one BASIC/UX process is trying to access the same file at the same time. 
For example, an ENTER normally hangs until the file is unlocked. If the file 
is locked by another BASIC/UX process on the same system, however, the 
ENTER returns error 481. 

Leaving SRM Files Open 

Because the BASIC/WS is a single user system, it can request that the 
SRM server close all files open for that system. This “clean up” operation is 
performed when the system boots, when a [Reset) key or SCRATCH A is done, 
etc. BASIC/UX, however, is a multi-user system, and such an action could 
cause the files of other users on the same system to be closed inappropriately. 
BASIC/UX attempts to close all files that it opens, however, there may 
occasionally be some left open for this reason. In general this is not a problem. 
These files may be closed by executing the “remove user” command on the 
SRM console, or running the hp-ux srmclean(l) utility. Be sure that no one 
else is using the SRM from that system before taking these actions. 

SRM Security 

Because the hp-ux operating system allows multiple users to access the SRM 
from the same system, some access security is lost. 

Using a Single SRM Interface Card with BASIC/UX 

The HP-UX operating system only supports one SRM card per system. This 
card can be shared simultaneously by several processes (BASIC/UX and/or the 
HP-UX SRM utilities), however, the performance will decrease as the number 
of processes using it increases. 

Accessing LIF Media by a Single User 

It is highly recommended that only one process access a LIF media at a time. 
The HP-UX operating system coordinates multiple processes accessing the HFS 
file system simultaneously, and the SRM server does the same thing for the 
SRM file systems. However, there is no such support for multiple processes 
accessing the same LIF media simultaneously. For this reason, if more than one 
process does try to access the same LIF media at the same time, the media 
may become corrupt and data may be lost. Also, the accurate detection of 
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media change can only be done when one process is accessing the media. Single 
process access is enforced for Amigo protocol devices. Once a process has 
begun accessing an Amigo protocol device, it “owns” that device until the 
[Reset] key is hit, a SCRATCH A is performed, or the process terminates. 


Overview of BASIC/UX Enhancements 

Since BASIC/UX runs on the HP-UX operating system, it provides you with 
essentially all of the capabilities of HP-UX. Here are the categories of these 
new features: 

■ Multi-tasking (the ability to run several processes/programs concurrently— 
for example, support of HP terminals). 

■ Multi-user environment (the ability for several users to use the system 
simultaneously). 

■ Additional system status and configuration information (regarding processes, 
operating system, and windowing system). 

■ Ability to run HP-UX commands from within BASIC/UX. 

■ Networking capabilities (such as remote file access and network file transfer). 

■ Window management capabilities (X Windows). 

■ Additional interface control: 

□ Interface mapping (for non-supported interfaces) 

□ Interface locking. 

□ Burst I/O. 

■ Use of HP-UX pipes. 

■ Selecting HP-HIL devices. 

■ HP-UX signal handling. 

■ HFS File buffering. 

■ Graphics buffering. 
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The following tables list the BASIC/UX enhancements to BASIC/WS. A 
manual name and chapter number are provided to help you locate more 
information on each feature. 


Legend for Subsequent Tables 


After each brief keyword description, the table gives a manual name and 
chapter number to help you locate more information about the feature briefly 
described in the table. Here are the acronyms used in the tables to specify 
BASIC manuals. 


GT 

IM 

IT 

LR 

PT 

UB 


BASIC/UX Graphics Techniques 

Installing and Maintaining the BASIC/UX System 

BASIC/UX Interfacing Techniques 

BASIC/UX Language Reference 

BASIC/UX Programming Techniques 

Using the BASIC/UX System 


Entering and Exiting 
the BASIC/UX Environment 


Since the BASIC/UX system runs on the HP-UX operating system, you have 
the ability to enter BASIC/UX from an HP-UX shell prompt. (You can 
also have your System Administrator set up your console to automatically 
“wake up” in the BASIC/UX system. See the Installing and Maintaining the 
BASIC/UX System for details.) 


Keyword/Feature 

Description 

For More 

Info 

rmb 

Enters you into the BASIC/UX system (from 
an HP-UX shell). 

UB 

Chapter 2 

QUIT 

Exits you from the BASIC/UX system 
(returns you to an HP-UX shell). 

UB 

Chapter 2 
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Multi-Tasking and Multi-User Capabilities 

You can run several BASIC/UX processes at the same time by executing the 
rmb command from within a windowing environment (while in an HP-UX 
shell). Each BASIC/UX process can be running a separate BASIC/UX 
program at the same time that other processes are running. (See Using the 
BASIC/UX System for instructions.) 

You can also have several users running processes concurrently on the HP-UX 
system. Each one will be on a separate console or terminal. (See the HP-UX 
documentation for more details on this capability.) 


System Status and 
Configuration Information 

The SYSTEMS function has some additional capabilities with BASIC/UX. 


Keyword / Feature 

Description 

For More 

Info 

SYSTEM$(“PROCESS ID”) 

Returns the process identifier of the 
main BASIC/UX process. 

UB 

Chapter 3 

SYSTEM$( “VERSION :OS”) 

Returns the operating system version 
and name. 

UB 

Chapter 3 

SYSTEMS 

(“WINDOW SYSTEM”) 

Returns information that describes 
the windowing system currently in 

use. 

UB 

Chapter 3 


Running HP-UX Commands from within BASIC/UX 

You can send commands to HP-UX while in the BASIC/UX system. For 
instance, the following command returns a printout of a calendar for the 
current month: 

EXECUTE "cal" 
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The results of the command appear in the HP-UX window from which 
BASIC/UX was started. 



Keyword/Feature 

Description 

For More 

Info 

EXECUTE 

Gives you access to the HP-UX 
operating system for executing 
commands and programs. 

UB 

Chapter 9 


Window Management 

A windowing system gives you the ability to partition your screen into several 
“panes”, each of which is the display for a process. The BASIC/UX system 
uses the X Windows system. (The X Windows documentation provides a more 
complete description of a windowing system.) 
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Key word/Feature 

Description 

For More 

Info 

CLEAR WINDOW 

Clears the contents of the specified 
window. 

UB 

Chapter 3; 

IT 

Chapter 17 

CONTROL CRT, 22 

Shuffles a specified window number to 
the top or bottom of the window stack. 

LR 

Appendix C; 
IT 

Chapter 17 

CREATE WINDOW 

Creates a window which can be 
accessed by BASIC/UX. 

UB 

Chapter 3; 

IT 

Chapter 17 

DESTROY WINDOW 

Deletes a window created by 

BASIC/UX. 

UB 

Chapter 3; 

IT 

Chapter 17 

LIST WINDOW 

Shows a list of all active BASIC/UX 
windows. 

UB 

Chapter 3; 

IT 

Chapter 17 

MOVE WINDOW 

Moves a window to another x-y location 
on the screen. 

UB 

Chapter 3; 

IT 

Chapter 17 

SCRATCH WINDOW 

Destroys all windows created from 
within the current BASIC/UX process. 
(Note that it will not remove the 
“boot” BASIC/UX window.) 

UB 

Chapter 3; 

IT 

Chapter 17 
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Additional Interface Control 

The BASIC/UX system runs “on top of’ the HP-UX multi-tasking, multi-user 
system. In this environment, several processes/users may attempt to access an 
interface simultaneously. Therefore, BASIC/UX provides a way of “locking” an 
interface to a process so that no other process(es) may use it. 

BASIC/UX also has the capability of using HP-UX’s “burst mode” of I/O 
operations. This mode is generally faster than the default (non-burst) mode of 
I/O operations used with BASIC/UX. 

There are a few interface cards that are not supported by BASIC/UX such as 
the EPROM and BCD interface cards. To access these interface cards, you 
need to use memory-mapped I/O. Once one of these interfaces is memory 
mapped into the BASIC/UX address space, you can access locations on the 
interface using the keywords READIO and WRITEIO. 

The following keywords and registers provide you access to the above 
mentioned features: 


K ey word / Feature 

Description 

For More 

Info 

CONTROL Sel.code, 255 

STATUS Sel.code, 255 

CONTROL turns interface mapping, 
locking, and burst I/O on or off. 
STATUS queries the status of locking 
and burst mode for the interface at 
the specified select code. 

IT 

Chapter 12 
and 

Chapter 16 


Using HP-UX Pipes 

The HP-UX system has a feature called a “pipe”, which is a special memory 
buffer that is used to hold the output of one command so that it can be used 
as the input to another command. Pipes may be used with the following 
commands: 
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Keyword /Feature 

Description 

For More 

Info 

ASSIGN 

These statements have been extended 
to allow piping of output to an HP-UX 
command (for example, to a spooler such 
as "1 pit"). 

IT Chap. 3 

CONTROL 


IT Chap. 6 

DUMP DEVICE IS 


GT Chap. 3 

ENTER 


IT Chap. 5 

OUTPUT 


IT Chap. 4 

PLOTTER IS 


GT Chap. 3 

PRINTALL IS 


PT Chap. 9 

PRINTER IS 


PT Chap. 9 

STATUS 


IT Chap. 6 

TRANSFER 


IT Chap. 9 




Selecting HP-HIL Devices 

With BASIC/UX, you have additional control capabilities for HP-HIL devices. 
You can enable or restrict a BASIC/UX process’ access to selected HP-HIL 
devices by setting and clearing bits in a mask. 


Keyword / Feature 

Description 

For More 

Info 

SET HIL MASK 

Enables the specified HP-HIL devices to be 
used by the BASIC/UX system. (All other 
HP-HIL devices cannot be used by this 
particular BASIC/UX process.) 

IT 

Chapter 19 
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Trapping HP-UX Signals 

HP-UX processes use signals to communicate among one another. BASIC/UX 
can set up interrupt-branching to trap these signals. 


Keyword/Feature 

Description 

For More 

Info 

ON EXT SIGNAL 

OFF EXT SIGNAL 

ON EXT SIGNAL defines an 
end-of-statement branch to be taken 
when an HP-UX signal is received. OFF 
EXT SIGNAL cancels the branch. 

PT 

Chapter 3 

STATUS 33, Register 

Queries HP-UX system signal 
information. (The Register number 
corresponds to an HP-UX signal. See 
the BASIC/UX Language Reference for 
a complete list of signals and register 
numbers.) 

PT 

Chapter 3 
and 

LR 

Registers 

Appendix 

ENABLE EXT SIGNAL 
DISABLE EXT SIGNAL 

Enable and disable a specified 

HP-UX signal to cause interrupts 
(end-of-statement branches) or to cause 
default actions. 

PT 

Chapter 3 


HFS File Buffering 

File buffering describes the way that the system handles data going to and 
coming from a disc. 

If file buffering is enabled: 

(default for BASIC/UX) 


If file buffering is disabled: 
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The system writes all file output data into a 
memory buffer. This buffer is then written onto 
the disc whenever it is filled, and at regular 
intervals (typically every 30 seconds) by the 
HP-UX syncer (1M) daemon. This buffering 
action reduces wear on the disc and speeds up 
most disc operations. 

All data output to the file is sent to the memory 
buffer then immediately to the disc. 












File buffering usually speeds up disc operations, but at the risk of losing the 
memory buffer’s contents (if power were to fail before the buffer is flushed). 

Note that file buffering is only available with HFS files. (LIF files are never 
buffered, and only the SRM controller dictates how buffering is handled with 
SRM files.) 


Keyword / Feature 

Description 

For More 

Info 

CONTROL IO.path, 9 
STATUS IO.path, 9 

CONTROL turns file I/O buffering on or 
off. STATUS queries the status of file I/O 
buffering. 

PT 

Chapter 8 


Graphics Buffering 

Graphics buffering describes the way that the system handles data going to and 
coming from the frame buffer. The following are GESCAPE operation selectors 
that help you perform graphics buffering: 


Keyword/ Feature 

Description 

For More 

Info 

GESCAPE 

Operation selectors have the 
following definitions: 

10 turns graphics buffering on; 

11 turns graphics buffering off; 

12 returns the current graphics 
buffering mode; 

13 flushes the graphics buffer. 

GT 

Chapter 2 
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BASIC/UX Mass Storage Enhancements 

This section covers mass storage enhancements included with BASIC/UX. 
Topics covered are: 

■ Locking HFS Files 

■ Accessing Networked HFS File Systems 

■ Using Long File Names on the HFS File System. 


Locking HFS Files 

The keywords LOCK and UNLOCK have been extended to work with HFS file 
systems. In general, the semantics are very similar to those of the SRM file 
system. For information on LOCKing and UNLOCKing HFS files, read the 
section “Locking HFS Files” in the chapter “Data Storage and Retrieval” found 
in the BASIC/UX Programming Techniques manual. 


Accessing Networked HFS File Systems 


BASIC/UX has been extended to allow access to networked HFS file systems 
through Remote File Access (RFA) and Network File Service (NFS). This 
allows files on other systems to be accessed in many of the same ways that 
local files are accessed. For information on networking with BASIC/UX, read 
the section “If You Have Networking Options” in the chapter “Using HP-UX 
Commands in BASIC/UX” found in the Using the BASIC/UX System manual 


Using Long File Names on the HFS File Systems 

The HP-UX operating system supports two types of HFS file systems. 

The Short File Name (SFN) system has a maximum file name length of 14 
characters. Long File Name (LFN) systems, however, allow files names to 
be up to 255 characters long. BASIC/WS only supports SFN file systems, 
however, BASIC/UX will work with both types. See your HP-UX operating 
system documentation for details. 
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Most BASIC/WS programs will run on a BASIC/UX system with little or 
no modification. This chapter describes the process of copying, running, 
debugging, and modifying BASIC/WS programs for use on BASIC/UX. 


General Steps 

1. Copy the BASIC/WS program to a disc that you are using for BASIC/UX. 
(This is a simple operation, since both systems can access HFS, LIF, and 
SRM discs.) 

2. Run the program to find all run-time errors. As you encounter each error, 
note the BASIC keyword and look it up in the preceding chapter or in the 
BASIC Language Reference. Make the change, and re-run the program to 
find the next run-time error. 

3. Once you have corrected all the run-time errors, you should store the 
program. 

4. Run the program again to locate all silent errors (ones that do not generate 
a BASIC error message, but that do cause the program to work differently 
on BASIC/UX). 

5. Once you have located and corrected all errors, store the program. This will 
complete the porting process. 
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Prerequisite 

If you are not already in BASIC/UX, you need to enter it before learning 
the above tasks. For information on how to do this, read the chapter called 
“Entering and Leaving BASIC/UX” in the Using the BASIC/UX System 
manual. 


Copying BASIC/WS Files to BASIC/UX 

BASIC/WS programs can be stored in files on three possible disc formats: 

■ HFS (Hierarchical File System). 

■ LIF (Logical Interchange Format). 

■ SRM (Shared Resource Manager). 

Since the BASIC/UX system also supports all three of these disc formats, you 
must decide whether to use the same disc or to use the HP-UX system’s HFS 
disc. This section describes the necessary steps for copying files. 

Prerequisites 

In order to use a LIF disc from BASIC/UX, the appropriate device files must 
be set up in your /dev/rmb directory. For information on how to do this, 
read the section “Setting Up LIF Devices” in the chapter “Maintaining the 
BASIC/UX System” in the Installing and Maintaining the BASIC/UX System 
manual. 

Copying Files from a LIF Disk 

The following steps copy a file from a LIF disk to your current BASIC/UX 
working directory. 

1. Catalog the files on the floppy using the CAT command. For example, the 
following command assumes you have a disk drive located at device selector 
702 with unit 1. 

CAT 702,1" 
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2. Look at the catalog listing of the files on the disk and select the file you 
wish to COPY. For example, if you select file Progl, execute the following 
command to copy the file into your current BASIC/UX working directory: 

COPY "Progl:,702,1" TO "Progl" 

This file can now be loaded as explained in the section “Debugging the 
Program.” 

Copying Files from an SRM Disk 

The following are steps required to copy a file from the SRM file system into 
the current working directory of your BASIC/UX system. (These steps assume 
your BASIC/UX system is connected to an SRM system through an HP 
98629A or HP 50961A interface card located in your computer’s backplane.) 
The steps are as follows: 

1. Catalog the files on the SRM file system using the CAT command. For 
example, the following command assumes the SRM interface is located at 
select code 8 and the file you are looking for is located in the root-level 
“USERS” directory on the server with node number 1. 

CAT "/USERS:REMOTE 8,1" 

2. Look at the cataloged listing of the files on the disk and select the file you 
wish to COPY. For example, if you select a file /USERS/Progl, execute the 
following command to copy the file into your current BASIC/UX working 
directory: 

COPY "/USERS/Progl:REMOTE 8,1" TO "Progl" 

This file can now be loaded into memory as explained the the section 
“Debugging the Program.” 

Copying Files from a 
Mounted HFS File System 

The following are steps required to copy a file from a mounted HFS disk into 
the current working directory of your BASIC/UX system. (These steps assume 
the HFS disk has been “mounted” in the HP-UX system. If not, see your 
System Administrator.) 
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The steps are as follows: 

1. Catalog the files on the HFS disk using the CAT command. For example, 
the following command assumes the HFS disk is mounted at the location of 
the “/users” directory. 

CAT "/users" 

2. The following COPY command copies the file named “Progl” located in the 
root-level “users” directory: 

COPY "/users/Progl:HFS" TO "Progl:HFS" 

where “Progl” is the name of the new copy of the file. (The files can have 
the same name if they are not in the same directory.) Note that if your 
current MASS STORAGE IS directory is on HFS, you may omit the ":HFS" 
portion of the above file specifiers. 


Debugging the Program 

Overview 

This section explains how to load, run, debug, and correct your BASIC/WS 
programs. 


Prerequisites 

You should have already copied all BASIC/WS programs into your current 
BASIC/WS working directory. 

Loading the Program 

To load a program, use either the GET or LOAD command. The GET 
command allows you to load ASCII and HP-UX files, and the LOAD command 
allows you to load PROG files. To determine whether the file you are loading 
is an ASCII or a PROG file, execute the CAT command. This command will 
list the TYPE attribute for the files in your current directory or the directory 
that you specified when you executed the CAT command. Once you have 
determined the type of file you are to load, you can then select the appropriate 
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command for loading that file. For example, assuming there is a file named 
Progl in the directory you are currently in, you would execute this command: 

GET "Progl" Get an “ASCII” or “HP-UX” type file. 

or 


LOAD "Progl" Load a “PROG” type file. 

Note that you can MSI to any file system (LIF, SRM, or mounted HFS) and 
use the above commands to load a file. For more information on loading 
programs read the chapter “Loading and Running Programs” found in the 
Using the BASIC/UX System manual. 

Running the Program 

To run a program that has been loaded into memory, use the RUN command. 
For example, type: 

RUM [ Return 1 

or press the softkey RUNT. 

Subsequent pages describe how to correct errors in the program. 

Recognizing and Correcting 
Run-Time Errors 

If the BASIC/UX system should encounter an error while the program is 
running (a “run-time” error), it will report an error message containing the line 
number where the error occurred. For example: 

ERROR 150 IN 110 Bad select code or device spec 

where 150 is the error number, 110 is the line number where the error occurred 
(in some cases it is the approximate line number), and Bad select code or 
device spec is the error message. These items are important in correcting 
your program’s run-time errors. It would be a good idea to write this 
information down as well as the statement that you feel caused the error. 
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The steps you need to take toward correcting your run-time errors are as 
follows: 

1. Look up the error number in the appendix titled “Error Messages” in 
the BASIC Language Reference. This will in some cases give you a more 
complete error message and better help you determine what is wrong. 

2. Use the statement’s keyword to direct you to the location in the “Summary 
of Keyword Differences” chapter that will help you in most cases find a 
solution to the run-time error. For example, if the run-time error is an I/O 
error dealing with the TRANSFER statement, then you would look for the 
TRANSFER statement in the “Summary of Keyword Differences” table in 
the preceding chapter. This table will give you a comparison of how this 
keyword is used on BASIC/WS and BASIC/UX. It also refers to a more 
detailed tutorial in one of the Techniques manuals. (Note that the BASIC 
Language Reference contains the most detailed information on each BASIC 
keyword. 

3. Once you have found what your error is, correct it and re-run the program. 
You should continue to do this until you have corrected all the run-time 
errors in your program. When the errors have all been corrected, you should 
make sure that there are no “silent” errors in the program. Silent errors are 
differences in the way the program actually runs now and how it should run 
(see the next section). 

4. When there are no more run-time errors in your program, you should 
RE-STORE or RE-SAVE it. 

Recognizing and Correcting 
Silent Errors 

Silent errors are differences between: 

■ The way the program should run, and 

■ The way it actually runs on BASIC/UX. 

They do not generate an error message, as is the case with run-time errors. 

For example, the color of your graphics output might have changed. This is 
not an error that would cause the program to stop working; however, it is an 
error and it must be corrected to make the program function as it did prior to 
running it on BASIC/UX. 
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The steps to take toward correcting your silent errors are as follows: 

1. Locate the places in the program that exhibit behavior different from the 
way the program used to work. 

2. Isolate the silent error to a certain part of your program by: 

■ Reading the program listing. 

■ Single-stepping through the program using the Step key ((fT) in the 
System menu of your ITF keyboard). 

■ Using the Pause key where unusual behavior occurs. 

The procedures for using these statements to troubleshoot a program are 
described in the chapter called “Debugging Programs” found in the BASIC 
Programming Techniques manual. Following the procedures explained in 
these sections will help you find the statement that is causing your silent 
error. 

3. Use the statement’s keyword to direct you to the location in the 
“BASIC/UX Differences and Enhancements” chapter that helps you, in 
most cases, find a solution to the silent error. For example, if the silent 
error is a graphics error dealing with the SEPARATE ALPHA FROM 
GRAPHICS statement, then you would look for this statement in the 
“Summary of Keyword Differences” table. The table gives you a comparison 
of how this keyword is different from BASIC/WS to BASIC/UX. It also 
provides a reference to more detailed information. Continue debugging until 
you have corrected all errors in your program. 

4. When the errors have all been corrected, RE-STORE or RE-SAVE the 
program. It is ready for use on BASIC/UX. 
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This chapter describes the new features of BASIC 6.0. It will help you 
determine what to do when moving programs from the 5.0/5.1 revisions of 
BASIC to 6.0. 

BASIC revision 6.0 is currently available in the Workstation implementation 
only (BASIC/WS). 


Compatibility with Previous Revisions 

BASIC/WS 6.0 is highly compatible with previous versions. This includes 

compatibility with the other implementations of HP BASIC including 

BASIC/UX and BASIC/DOS. Using BASIC/WS 6.0 you can: 

■ LOAD and RUN program (PROG) files created with STORE on previous 
versions of BASIC. 

■ GET and RUN program (ASCII or HP-UX) files created with SAVE on 
previous versions of BASIC. 

■ use all data files (BDAT, ASCII, and HP-UX) created on previous versions of 
BASIC. 

Note if you are using compiled subprograms (CSUBS), you 

must relink them using the BASIC 6.0 CSUB Utility (sold 
separately). Refer to the section “CSUB Enhancements” for 
more information. 
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New Hardware Support 


New SPU Support 

BASIC 6.0 includes support for the Model 345, 375, and V/360 computers. 


New System Hardware Supported 


Computer Model 

BASIC Language Support 

Model 345 1 

BASIC Main (no binary required) 

Model 375 1,2 

BASIC Main (no binary required) 

Model V/360 

Operation supported by BASIC Main (no binary required). 
VXIbus access provided via the optional VXI binary and 
utilities. 


J The Centronics interface that is available with these systems is not supported 
by BASIC. 

2 The MC68040 processor upgrade available for this system is not supported by 
BASIC. 

New Interface Support 

BASIC 6.0 supports the SCSI interface only for use with SCSI-based disc 
drives. SCSI is not supported for peripherals other than disc drives; no SCSI 
Level II devices are supported. BASIC 6.0 also supports access to the VXIbus 
when used with the Model V/360 embedded VXI controller and the VXI 
binary. 
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New Interface Hardware Supported 


Interface 

BASIC Language Support 

SCSI 1 

Provides support for SCSI-based disc drives only. Does not 
support SCSI tape drives or general SCSI interface I/O 
operations. Requires SCSI binary. 

VXI 2 - 3 

Provides Model V/360 with the capability to access and 
manipulate the VXIbus backplane and VXIbus instruments 
directly. Requires VXI binary. 


1 Booting from a SCSI disc drive requires boot ROM revision C or later. Series 
200 computers and some Series 300 computers do not include this boot ROM 
revision and cannot provide system boot capability. In this situation, BASIC 
can boot from a different interface (HPIB or SRM), load the SCSI binary, and 
then access SCSI drives. 

2 Direct VXIbus access is only supported on the Model V/360 embedded VXI 
controller. 

3 The VXI binary and utilities are not included in the standard BASIC/WS 
product. This binary and the utilities are available as a separated product from 
Hewlett-Packard. 


BASIC Language Convergence 

A number of language extensions were made to the HP BASIC language 
definition with the introduction of BASIC/UX. For details about these 
enhancements, refer to the “BASIC/UX Differences and Enhancements” 
chapter of this manual. To provide better compatibility between BASIC/WS 
and BASIC/UX applications, BASIC/WS 6.0 has incorporated these language 
extensions. 
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The operation of these keywords on BASIC/WS systems differs in some cases 
from the BASIC/UX definition. Generally, BASIC/WS operation of these 
keywords falls into three categories: 

■ Keywords that syntax and list, but do not execute. 

■ Keywords that syntax, list and execute, but have no effect upon system 
operation or return a known value. 

■ Keywords that syntax, list, execute and provide capability similar to the 
BASIC/UX definition. 

This section provides a brief summary of these differences and enhancements. 
For a detailed description of a particular keyword, refer to the HP BASIC 
Language Reference. 

All keywords listed in the following tables will syntax, LIST and LOAD on 
BASIC/WS 6.0. For each BASIC/UX keyword, the table includes information 
about the binary file required for operation and how this keyword operates in 
BASIC/WS 6.0. 
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Keywords From BASIC/UX 


Keyword 

Binary 

Execution in BASIC/WS 

CLEAR WINDOW 

RMBUX 

ERROR 

Not a in Window System 

CREATE WINDOW 

RMBUX 

ERROR 

Not a in Window System 

DESTROY WINDOW 

RMBUX 

ERROR 

Not a in Window System 

LIST WINDOW 

RMBUX 

ERROR 

Not a in Window System 

MOVE WINDOW 

RMBUX 

ERROR 

Not a in Window System 

DISABLE EXT SIGNAL 

RMBUX 

ERROR 

Feature not supported by this OS 

ENABLE EXT SIGNAL 

RMBUX 

ERROR 

Feature not supported by this OS 

ON EXT SIGNAL 

RMBUX 

ERROR 

Feature not supported by this OS 

OFF EXT SIGNAL 

RMBUX 

ERROR 

Feature not supported by this OS 

ENABLE EXT SIGNAL 

RMBUX 

ERROR 

Feature not supported by this OS 

EXECUTE 

RMBUX 

ERROR 

Feature supported by this OS 

QUIT 

RMBUX 

ERROR 

Feature not supported by this OS 
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Keywords From BASIC/UX (continued) 


Keyword 

Binary 

Execution in BASIC/WS 

SET HIL MASK 

None 

This statement has no effect. 

SET TIME 

CLOCK 

With no argument, this statement has no 
effect. 

SET TIMEDATE 

CLOCK 

With no argument, this statement has no 
effect. 

SYSTEM$("PROCESS ID") 

CRTX 

This function returns 0. 

SYSTEMS("VERSION:OS") 

None 

This function returns 6.0 WS. 

SYSTEMS("WINDOW SYSTEM") 

None 

This function returns Console. 

TIMEZONE IS 

CLOCK 

With no argument, the statement has no 
effect. 

PLOTTER IS numexp, 

UINDOV 

GRAPH 

ERROR 

Not in a window system. 

DUMP ALPHA numexp ... 

None 

The numeric expression must evaluate to 

1 or an error will occur. 

DUMP DEVICE IS strexp 

GRAPH 

This is a variant of DUMP DEVICE 

IS where strexp specifies a file as the 
destination pf DUMP ALPHA or DUMP 
GRAPHICS. The behavior is analogous 
to PRINTER IS file. 

PRINTALL IS strexp 

None 

This is a variant of PRINTALL IS, where 
strexp specifies a file as the printall 
device. The behavior is analogous to 
PRINTER IS file. 


24-6 Porting to 6.0 



















Keywords From BASIC/UX (continued) 


Keyword 

Binary 

Execution in BASIC/WS 

GESCAPE CRT, selector 

GRAPHX 

GESCAPE selectors 10-13 were added 
to BASIC/UX to control graphics 
buffering. BASIC/WS 6.0 will accept 
these selectors, and always return “0”. 
These commands have no effect. 

CONTROL sc, 255 

STATUS sc, 255 

HPIB or 
GPIO 

Register 255 was added to HPIB and 

GPIO interfaces to control interface 
locking, mapping and IO Burst 
extensions. BASIC/WS accepts 
these registers and return “3”. These 
commands will have no effect. 

CONTROL 9path, 9 

STATUS Qpath, 9 

None 

For paths assigned to file names, this 
register controls file buffering on a per file 
basis. BASIC/WS accepts these registers 
and returns “0”. These commands have 
no effect on BASIC/WS. 

CONTROL sc,22 

STATUS sc,22 

None 

This register was added for window 
support in BASIC/UX. The Not in a 
window system message will be reported 
if executed. Values of sc between 600 and 
699 are not be accepted. 

CONTROL sc,23 

STATUS sc,23 

None 

This register was added to return 
terminal compatibility mode. BASIC/WS 
accepts this register when sc evaluates to 

1 (CRT) and always returns “1”. These 
commands will have no effect. 
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Keywords From BASIC/UX (continued) 


Keyword 

Binary 

Execution in BASIC/WS 

CONTROL 33; numexp 

STATUS 33; numexp 

None 

This pseudo select code was added to 

manage external signals in BASIC/UX. 
BASIC/WS will not support this select 
code. An error will be reported if a 
statement accessing select code 33 is 
executed. 

SCRATCH ALL 

SCRATCH A 

SCRATCH BIN 

SCRATCH B 

SCRATCH COM 

SCRATCH C 

SCRATCH RECALL 

SCRATCH R 

SCRATCH WINDOW 

SCRATCH W 

None 

Additional SCRATCH secondaries were 
added as aliases of other SCRATCH 
secondaries. All of these secondaries will 
be accepted by BASIC/WS. 


Globalization Enhancements 

In addition to the one-byte ASCII and Japanese Katakana character sets 
supported by previous revisions, BASIC/WS 6.0 also supports two-byte 
characters, such as Japanese Kanji. The support of general two-byte character 
handling is called globalization. Note that you must purchase specific 
localization binaries to get support for a particular language’s character set. At 
the time of first release, BASIC/WS 6.0 supports localization for Japanese only. 
Localization binaries for other two-byte languages may be available at later 
dates—contact your local Hewlett-Packard Sales Representative for details. 

A new globalized CRT driver, CRTD, is included in BASIC 6.0. You do not 
need to use CRTD unless you are using a localized version of BASIC. 
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Some new keywords are available to support two-byte characters, but they 
are not discussed in this chapter. The keywords added to support two-byte 
character handling are: 

■ CVT$ 

■ DICTIONARY IS 

■ FBYTE 

■ GFONT IS 
■SBYTE 

■ S YS T E M $ (va rio us.specific rs ) 

■ Secondary keywords: 

□ EXCHANGE 

□ SHIFT IN/OUT 

Globalization, localization,two-byte characters, and CRTD are discussed in 
detail in the “Globalization Overview” and “Features of Globalized BASIC” 
chapters of this manual. 


File Related Enhancements 

Wildcards 

BASIC 6.0 supports wildcards for file name matching with many file related 
commands. Note that wildcard recognition is disabled at power-on and 
after SCRATCH A or SCRATCH BIN; you must manually enable wildcard 
recognition. 

For a detailed discussion of wildcards with examples, refer to the 
WILDCARDS entry in the HP BASIC Language Reference. 
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Appending To Files 

BASIC 6.0 allows you to specify the optional secondary keyword APPEND 
with many commands which write to files. When APPEND is omitted, the file 
is overwritten, M^hen APPEND is specified, new data is appended to the end 
of the file. 

The following commands support APPEND: 

■ ASSIGN 

■ DUMP DEVICE IS 

■ PRINTALL IS 

■ PRINTER IS 

■ PLOTTER IS 

Refer to the HP BASIC Language Reference for details on the proper use of 
APPEND with each keyword. 

Replacing Existing Files 

BASIC 6.0 allows you to specify the secondary keyword PURGE with the 
following file related commands: 

■ COPY 

■ LINK 

A More Forgiving GET 

BASIC 6.0 allows you to GET files that use a carriage return/line feed 
combination to terminate a line. This makes it easier to GET files created on 
certain computers, such as PCs. 
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Human Interface Enhancements 


READ KEY 

BASIC 6.0 provides READ KEY to allow you to read typing-aid softkey 
definitions created with SET KEY. Refer to the HP BASIC Language 
Reference for a detailed description with examples. 

RUNLIGHT ON/OFF 

BASIC 6.0 allows you to turn on or off the runlight (status indicator) at the 
bottom right side of the display using RUNLIGHT ON/OFF. This allows you 
to create more tidy displays and it is especially useful for making neat graphics 
dumps to printers. 


CSUB Enhancements 

The internal architecture of BASIC revision 6.0 and above is designed to ease 
the maintenance associated with compiled subprograms (CSUBS). When 
you port a program containing CSUBS from any prior revision of BASIC to 
6.0, you must relink the CSUBS using the BASIC 6.0 CSUB Utility (sold 
separately). However, CSUBS compiled for BASIC 6.0 will port directly to 
BASIC revisions 6.0 and above without relinking. 
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Binary Enhancements 


New Binaries 

some new binaries. 

This binary allows non-BASIC/UX implementations of 
BASIC to syntax, list, and execute certain commands 
previously available only in BASIC/UX. These 
commands are summarized in this chapter in the 
section “BASIC Language Convergence”. 

CRTD This display binary (CRT driver) is included primarily 

to support the two-byte raster characters used by 
certain localized versions of BASIC, such as Japanese 
localized BASIC. 

Changes in HFS Binary 

Certain keywords previously required the HFS binary. The following keywords 
no longer require HFS or any other binary to execute: 

■ LINK 

■ PERMIT 

■ CHOWN 

■ CHGRP 


BASIC 6.0 includes 
RMBUX 
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Miscellaneous Additions and Changes 


Keyword Additions and Changes 


Keyword, 

INMEM 

CALL 

SCRATCH 


Description 

This function tests whether the specified 
subprogram is in memory. 

The CALL statement now supports calling 
subprograms specified by a string, for example: 
CALL Subname$ WITH (Paraml ,Param2$) 

The SCRATCH statement now accepts the 
specifiers ALL, B, COM, RECALL, W, and 
WINDOW. 


SYSTEMS The SYSTEMS statement now allows you to 

request current settings for: 

■ WILDCARDS 

■ WINDOW SYSTEM 

■ PROCESS ID 

■ VERSION:OS 

■ VERSION:BASIC 


Additional requests are allowed when 
localization binaries are loaded. 


CRT Register 21 

BASIC 6.0 expands the function of CRT STATUS/CONTROL register 21. In 
previous versions of BASIC, this register was used only to indicate whether 
the display was in bit-mapped or non-bit-mapped mode. In BASIC 6.0, this 
register is used to selectively activate any one of the supported CRT binaries 
that are currently in memory. Refer to the STATUS/CONTROL register tables 
in the “Interface Registers” appendix of the HP BASIC Language Reference for 
details. 
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Installation/Booting Change 

Previous versions of BASIC contained factory-supplied system files on a single 
flexible disc. In BASIC 6.0, some factory-supplied media options contain 
system files on two discs. This has a minor impact on installation and booting 
(for systems that boot from flexible discs). These differences are documented in 
Installing and Maintaining HP BASIC. 

New Error Messages 

BASIC 6.0 includes various new error messages to support keyword 
enhancements. Refer to the error message summary in the back of the HP 
BASIC Language Reference for a complete listing. 


Documentation Changes 

Prior to BASIC 6.0, BASIC Graphics Techniques was published as a separate 
manual. In BASIC 6.0, BASIC Graphics Techniques is no longer a separate 
manual; it has been integrated into HP BASIC Programming Techniques, 
Volume 1: General Topics and Graphics. 

The HP BASIC Language Reference and HP BASIC Condensed Reference 
are now keyed to indicate how each keyword is supported on the various 
implementations of BASIC. The following implementations are documented: 

■ BASIC/WS—HP BASIC Workstation 

■ BASIC/UX—HP BASIC running on HP-UX 

■ BASIC/DOS—HP BASIC running on the BASIC Language Processor in a 
PC 

■ BASIC/IN—HP Instrument BASIC running inside a test and measurement 
instrument 
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Globalization allows BASIC to process strings containing two-byte characters. 
This chapter contains brief, general descriptions of globalization and two-byte 
characters. To learn how to program with two-byte characters, read the 
following chapter, “Features of Globalized BASIC.” 

You do not need to read this chapter unless you plan to write programs that 
use two-byte characters. 


Globalization Support 

These features are supported by BASIC/WS version 6.0 and above. 
BASIC/UX/DOS/IN does not support globalization. The new features added 
to globalized BASIC do not change the way it behaves when processing 
one-byte characters, such as Extended US ASCII. Thus, BASIC/WS 6.0 is 
backward compatible. 

To use most globalized features in a meaningful way, you must purchase a 
localized version of BASIC with specialized language binaries. A localized 
version is one that supports a specific two-byte language, such as Japanese. 
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Related Documents 


Since programming with globalized BASIC is an advanced topic, you should 
already be familiar with BASIC in general. In particular, you need to 
thoroughly understand how to input, process, and display character data 
using BASIC with your display and keyboard. If you think you need more 
background information, consider the following topics: 


Topic 

Programming with 
Character Data 


Using the Keyboard 


Using the Display 


Local Language 
Programming 


Suggested Reading 

See the chapter “String Manipulation” in HP BASIC 
Programming Techniques, Volume 1: General Topics. 
For a list of string functions, see the listing under the 
headings String Operations and Globalization in the 
appendix “Keyword Summary” of the HP BASIC 
Language Reference. 

See the “Keyboard Interface” chapter of HP BASIC 
Interfacing Techniques, Volume 2: Specific Interfaces. 
For a detailed description of all the keys available, refer 
to the appendices of Using HP BASIC. 

See the “Display Interfaces” chapter of HP BASIC 
Interfacing Techniques, Volume 2: Specific Interfaces. 

If you purchased a localized version of BASIC, you 
should also have a manual titled Using LanguageX with 
HP BASIC, where Language A is a local language. 

This manual explains the details specific to your 
localized version such as character sets, supporting files, 
and keyboard entry methods. 
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Terminology 

This chapter explains the meaning of most special terms at the time they are 
first used. However, you need to understand the following terms before you 
continue: 

■ Globalization 

■ Localization 

Globalization and Localization 

Globalization and localization are related, but they are not the same. 
Globalized BASIC is a version of BASIC that supports two-byte characters 
internally and displays them using the CRTD binary. Two-byte characters 
are used by certain non-Roman languages, such as Japanese. However, 
globalized BASIC does not support a specific language. For example, to use 
Japanese characters with BASIC, you must purchase specific Japanese FONT, 
LANGUAGE, and INPUT binaries from Hewlett-Packard. Localized BASIC 
is globalized BASIC into which INPUT, LANGUAGE, and FONT have been 
loaded. 

Consider this analogy. Globalized BASIC is like a laser printer that can accept 
font cartridges for many fonts. The localization binaries are like font cartridges 
Just as you must plug a font cartridge into the printer to print with a special 
font, you must load localization binaries into globalized BASIC. Most laser 
printers provide a default internal font that is accessible whether or not a font 
cartridge is installed. Similarly, globalized BASIC contains one-byte Extended 
ASCII and Katakana whether or not any localization binaries have been 
installed. 


Note BASIC can only support one set of localization binaries 

at a time. Thus, you cannot simultaneously load INPUT, 
LANGUAGE, and FONT for more than one language. 
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Understanding One- and Two-Byte Characters 


Overview 

The key to understanding globalization is understanding one- and two-byte 
characters. Normally, BASIC assumes that each character in a string is one 
byte long. This applies to characters stored in memory, displayed on the 
screen, or entered from the keyboard. 

To enable BASIC to process two-byte characters, you must: 

■ LOAD BIN the globalized CRTD display binary. 

■ LOAD BIN localized LANGUAGE, INPUT, and FONT binaries. 

■ Activate the CRTD binary (using CRT CONTROL register 21). 

You can then use two-byte characters in the BASIC editor for variables, 
labels, and string literals. You can also use two-byte characters in application 
programs as keyboard input and screen output. 


100 ! Z <J) J U ?=? 1* \$ \ h 0) fa® <D ^ ^ % t 

1 10 PRINT " 10 £ T‘©1|: " 

120 ! 

130 mtti 1 

140 FOR »=? = 1 TO 10 
150 CRLL 
1G0 NEXT 
170 END 
180 ! 

190 SUB $ ¥ 0 % 7F ( $ ? ) 

200 PRINT 
210 SUBEND 

A Program Listing with Two-byte Characters 
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A Graphics Plot with Two-byte Characters 


Globalized BASIC and localized BASIC can process and display a mixture 
of one-byte and two-byte characters. For example, it is possible to create 
a bilingual error message string containing both one-byte English and and 
two-byte Japanese. 

"Stop Test " t § tl tz ft 3 L T < tz £ 

A Message with One- and Two-Byte Characters 

The One-Byte World 

The one-byte characters that non-localized BASIC recognizes are US 
ASCII/European display characters and Japanese Katakana display characters. 
Refer to the “Useful Tables” chapters of the HP BASIC Language Reference or 
the HP BASIC Condensed Reference for a complete listing. Each character set 
is a definition of 256 codes that represent letters in an alphabet, typographic 
symbols, control characters, and display enhancement characters. 
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For example, if you are using an HP series 300 computer, the codes are 
assigned like this: 


Series 300 Extended ASCII Display Characters 


Code Range 

Functions 

Decimal 

Hexadecimal 


0-31 

00-IF 

Non-printable 7-bit ASCII control characters 

32-64 

20-40 

7-bit ASCII typographic symbols and digits 

65-126 

41-7E 

7-bit ASCII alphabet and punctuation symbols 

127 

7F 

Delete 

128-135 

80-87 

Alpha display enhancement characters 

136-143 

88-8F 

Alpha display pen colors 

144-160 

90-A0 

Reserved 

161-241 

Al-Fl 

European alphabet and punctuation characters 

242-254 

F2-FE 

Miscellaneous 

255 

FF 

Non-ASCII prefix 


These code definitions are adequate for the one-byte world of Roman 
characters. However, they do not address several problems encountered with 
characters in non-Roman languages. In particular, these languages: 

■ have alphabets of more than 256 characters 

■ are more typographically complex 

■ use some fundamentally different input methods 

The Two-Byte World 

In the previous discussion, we saw how ordinary BASIC uses one-byte codes 
to identify each Extended ASCII character. Similarly, globalized BASIC uses 
two-byte codes to identify each character. Two bytes are required because of 
the large number of characters available in many Asian alphabets. 
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Two-byte characters are coded in HP-15 and HP-16. HP-15 codes are used 
to represent characters inside software applications, while HP-16 codes are 
used primarily to send characters to peripherals, such as printers. HP-15 and 
HP-16 are coding systems that can be used to specify characters for a variety 
of languages. They specify a region of code space into which characters may be 
mapped, but not the characters themselves. 

Note that only parts of the available code space in HP-15 and HP-16 define 
valid two-byte codes. If either byte of a potential two-byte code falls outside 
the valid region, both bytes are treated as one-byte codes. As the last 
statement implies, one-byte and two-byte characters coexist inside BASIC. 
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Two-byte Languages 

Different languages require different numbers of characters. For this reason, it 
is not possible to make any general statement about how much of the HP-15 
or HP-16 code space is filled with printable characters. For example, HP-15 
Korean character codes fill only about one fourth of the available code space. 



Second Byte* 

□ — Defined Characters 
^3 — Undefined Characters 
* — Byte values in hexadecimal 

HP-15 Korean Character Codes 

Languages do not always provide distinct printable characters for all codes in a 
region. Unused codes within a region are typically filled with galley characters, 
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which are essentially blank placeholders of the same physical dimensions as 
other printable two-byte characters. 


A 

• • 

9_ft 

L L 

1 —Normal 1 

A 



Using PRINT (raster font) 


r 


c 


Using LABEL (graphics font) 


two—byte galley character (blank) 
Normal two—byte character 


Two-byte Galley Characters 

One-byte or Two-Byte? 

Localized BASIC must frequently break character strings into ordered lists of 

bytes and classify them as one- or two-byte characters. As a programmer, you 

may need to perform the same analysis, so let’s examine the algorithm: 

1. Get the first byte of the string. 

2. If the first byte is not in the valid range of two-byte characters, then treat 
it as a one-byte character. Go to step one and continue the procedure with 
next character. 

3. If the first byte is in the valid range for two-byte characters, get the second 
byte. If the second byte is in the valid range for two-byte characters, treat 
the pair as a single two-byte character. If the second byte is not in the valid 
range for two-byte characters, treat each byte as a single one-byte character. 
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Two-Byte Character Conversions 

Two-byte languages differ from one-byte languages in many ways. Most 
one-byte languages, such as English, have a single alphabet composed of 
relatively few characters. Consequently, most characters are available directly 
as labeled keys on the computer keyboard. In general, keyboards, displays, and 
printers for a particular one-byte language all use the same basic codes for the 
printable characters in the alphabet. Thus, one-byte languages use a single 
alphabet that maps directly to a single set of character codes. 

In two-byte languages the situation is more complex. Many two-byte 
printers use character codes different from the codes used by computers. 
Therefore, programs must convert from one coding system to another when 
using certain peripherals. Two-byte languages may include more than one 
alphabet in their character set. Consequently, programs using two-byte 
characters must sometimes convert between alphabets by translating strings 
character-by-character. Since two-byte languages often have more characters 
than can fit on a keyboard, different keyboard input methods must be used. 
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Converting Codes 

Globalized BASIC uses HP-15 to represent any two-byte characters that are 
stored internally. Therefore, all characters displayed on the screen, including 
both raster and graphics fonts, are HP-15. Since some two-byte printers use 
HP-16 to print two-byte characters, localized BASIC provides a way to convert 
between the two. In the next chapter, we will discuss how BASIC accomplishes 
this with EXCHANGE. 



Character Conversion Using EXCHANGE 
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Converting Alphabets 

Many two-byte languages contain several alphabets or several dialects. In 
addition, some two-byte languages have adopted methods for using Roman 
characters to express words phonetically. For example, Japanese words can be 
written in three different alphabets. 


Japanese Alphabets in HP-15 


Alphabet 

Description 

Katakana 

Hiragana 

Kanji 

Simplified phonetic alphabet 

Phonetic alphabet 

Traditional alphabet 


Because of the different alphabets available, Japanese localized BASIC must be 
able to quickly convert from one alphabet to another, character-by-character. 

In the next chapter, we will discuss how BASIC accomplishes this with CVTS. 

Converting Keyboard Input 

Some two-byte languages use special keyboard input conversions to enter 
two-byte characters. An operator may type in a string phonetically and then 
press a conversion key to translate the string word-by-word. For example, a 
Japanese operator might type in a string in Hiragana and press a conversion 
key to automatically translate the string to Kanji. Details of these types of 
input procedures are outlined in the manual Using LanguageX with HP BASIC, 
where LanguageX is a local language, such as Japanese. 
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Inside Globalized BASIC 

Now that you understand two-byte characters, let’s look at what has been 
added to BASIC to handle them. Globalized BASIC contains additional 
binaries, mainframe keywords, and support for localization binaries. 


Globalized BASIC 


/ " ‘ \ 

Binaries 


• CRTD 
v_> 


/ ' \ 

MainFrame 

• FBYTE 

• SBYTE 

• SYSTEM! 


Localized BASIC 


Binaries 


• LANGUAGE 

• INPUT 

• FONT 

___ 1 


\ 

Support Files 

• graphics font 

• dictionaries 

___ / 


Globalized BASIC—Additions and Enhancements 
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New Globalized Features 


Location 

Name 

Description 

Binary 

CRTD 

The new binary CRTD is a globalized display 
driver required for displaying two-byte characters. 
Note that CRTD works with bit mapped displays 
only; it does not work with the HP 98700 graphics 
display station or HP Series 200 computer 
displays. 

Mainframe 

FBYTE/SBYTE 

The BASIC mainframe includes two new string 
functions, FBYTE and SBYTE, used to determine 
the one/two-byte identity of character strings. 

Mainframe 

SYSTEMS 

Globalized BASIC can return additional system 
settings for GFONT IS, LANGUAGE, VERSION:, 
CONVERSION BUFFER, and DICTIONARY IS:. 
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New Localized Features 


Location 

Name 

Description 

inary 

INPUT 

This binary supports keyboard entry of two-byte 
characters. Key mapping, dictionary lookup functions, 
and alphabet conversions are provided for keyboard 
entry. The DICTIONARY IS statement requires this 
binary. 

Binary 

LANGUAGE 

This binary supports two-byte character graphics fonts 
for the GRAPH binary. This binary also contains 
most localization related keywords including CVT$, 
GFONT IS, EXCHANGE, SHIFT IN/OUT, and 
several new SYSTEMS extensions. 

Binary 

FONT 

This binary provides raster character fonts for both 
one- and two-byte characters. It contains other font 
information required by CRTD. 

Files 

> 

Dictionaries, Graphics Fonts 

Most localized versions of BASIC contain one or more 
support files. These files may include system and 
user defined dictionaries for alphabet and phrase 
conversion. A file containing graphics font data is 
always included. 
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This chapter describes how to use the two-byte character handling features of 
globalized BASIC. Two-byte characters are used by certain languages, such as 
Japanese. You should read the preceding chapter “Globalization Overview” 
before reading this chapter. 


Using Keyboards 

This section reviews the keyboard input methods available for one-byte 
characters and presents the enhanced two-byte methods. 

Review of One-Byte Character Input 

BASIC provides a variety of methods for keyboard input in the one-byte world 
You need to understand these methods because they are reused and extended 
in globalized, two-byte BASIC. If you have difficulty understanding or using a 
particular method for two-byte character entry, refer back to this section. It is 
often easier to learn an input method in the one-byte world and then apply it 
in the two-byte world. 
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This review covers the following character input methods: 


One-Byte Character Input Methods 


Input Method 

Description 

Direct 

Enter characters by pressing the labeled keys on your keyboard. In 
general, these are the printable letters, numbers, and punctuation 
symbols. 

Extended 

Enter characters other than the ones labeled on your keycaps using 
f Extend char). In general, these characters are the printable letters, 
numbers, and punctuation symbols. 

Any Char 

Enter any character recognized by BASIC in the entire code range 
0-255. This method can be used for printable or non-printable 
characters. 

Non-ASCII 

Simulate a keypress for a non-ASCII key using (CTRL). This is 
useful for simulating keys such as (insert char), (Clear line), and arrow 
keys. 

Programmatic 

Generate characters inside a BASIC program using CHR$, VAL$, 
or similar functions. 


Direct Keyboard Entry 

Direct keyboard entry is the input method normally associated with a 
keyboard. This is the method you use to type in a numbered program 
statement in the BASIC editor. To use this method, you simply press the key 
with label corresponding to character you wish to enter. 


Direct Keyboard Entry Examples 


To Enter ... 

You Type ... 

A 


•/. 

© 

Red 

dXDGD 
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Note that not all labeled keys generate a character. Some keys take a specific 
action, such as (insert line) , (Return) , (Caps 1 , and ( Stop ) . You cannot use direct 
keyboard entry to input these keystrokes into a quoted string; refer to the 
following section “Non-ASCII Key Entry.” 

Extended Keyboard Entry 

BASIC recognizes one-byte codes for US Roman, European Roman, and 
Japanese Katakana characters whether or not localization binaries are loaded. 
However, most keyboards are designed and labeled to use only one group of 
characters at a time. You must press f Extend char 1 while simultaneously pressing 
another key to access other characters. For example, the HP 46021A ITF 
keyboard is configured like a standard US typewriter. You can acce ss the 
European Roman characters on the HP 46021A keyboard using the f Extend char 1 
key. 


Extended Keyboard (HP 46201A) Entry Examples 


To Enter ... 

You Type ... 

fi 

( Extend charMT) 

6 

[Extend char)-(u} fo} 

ft 

(Extend char)-(7) fn} 


The native language of the keyboard determines what characte rs are avail able 
as direct input keys and what characters are available through ( Extend char) . 

Extend Keys. The mechanical design of HP keyboards makes it possible to 
have more than one extended character key. The generic name for this type 
of key is an extend key. The names printed on these keys varies slightly 
depending on the native language of the keyboard, but the position is the 
same. Such keys are located adjacent to the space bar to the right and left. In 
general, there can be up to four extend keys. 
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Shift 

Z 

X 

C 

V 

B 

N 

M 

< 

» 

> 

9 

/ 

Shift 



Space Bar 




I 


Left Extend 
— Left-Left Extend 


Right Extend — 1 
Right—Right Extend— 1 

Extend Keys 


Any Char Keyboard Entry 

The direct and extended keyboard entry methods provide an easy way to input 
most printable characters. But some valid characters in the BASIC character 
set do not map to either normal or extended keys. You can enter these “keyless 
characters”, or any other character, using the ANY CHAR softkey. 

To input a character using this method, simply press ANY CHAR followed by 
the three digit decimal code for that key. You can find a complete list of codes 
in the US/European/Katakana display codes table in the “Useful Tables” 
appendix of the HP BASIC Language Reference or in the back of the HP 
BASIC Condensed Reference. 

ANY CHAR Keyboard Entry Examples 


To Enter ... 

You Type ... 

A 

ANY CHAR©©© 

£ 

ANY CHAR (HD© 

ENQ 

ANY CHARfoYoYin 

ACK 

ANY CHAR©©© 


Non-ASCII Key Entry 

Certain keys on the BASIC keyboard take immediate actions instead of 
generating characters. This type of key inlcludes [ insert char 1 and ( clear display ] . 
You may want to type one of these characters into a quoted string in BASIC 
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instead of taking the action labeled on the key. You can enter | Clear display 1 
within a quoted string by pressing ( CTRL H Clear display 1 . The key appears on the 
screen as a two-character sequence beginning with 1|. 


Non-ASCII Key Entry Examples 



For additional details, refer to the section titled “Second Byte of Non-ASCII 
Key Sequences” located in the “Useful Tables” appendix of the HP BASIC 
Language Reference. 


Note Do not confuse the two-character sequence used to represent 

non-ASCII keys with the two-byte characters used by 
globalized BASIC. 
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Programmatic Character Entry 

All of the character entry methods discussed previously are designed to permit 
humans to interactively input characters from a keyboard. The methods for 
generating characters within a program are somewhat different. The most 
common methods for generating strings programmatically are: 

CHR$ The CHRS function converts a decimal number into one 

byte of a character. For example, on a system using US 
ASCII, CHR$(65) is equivalent to "A". 

VALS The functions VALS, DVAL$, and IVALS convert 

numeric values into character strings composed of 
digits. VALS creates only decimal digits, while DVALS 
and IVALS can create binary, octal and hexadecimal 
digits. 

OUTPUT KBD Sometimes it is useful to make your BASIC program 

send characters to the keyboard buffer using 
OUTPUT KBD. This accurately simulates human 
keystrokes. For example, OUTPUT KBD; "NO" can be 
provide a default response to a query. Note that the 
quoted string may contain any simulated keystrokes, 
including non- ASCII keys such as [insert char] . 
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Two-Byte Character Input 

This section describes the two-byte character input methods available in 
globalized BASIC. If you have not already done so, read the preceding section 
“Review of One-byte Character Input” to familiarize yourself with input 
terminology. 



Two-Byte Character Input Methods 

Input Method 

Comments 

Direct 

Enter characters by pressing the labeled keys on your keyboard. 

This input method is not available for two-byte characters. 

Extended 

Enter characters other than the ones labeled on your keycaps 
using [Extend char). This input method is not available for two-byte 
characters. 

Any Char 

Enter any character recognized by BASIC one byte at a time using 
Any Char . This method can be used from any keyboard to enter 
one- or two-byte characters. 

Non-ASCII 

Simulate a keypress for a non-ASCII key using [CTRL). This method 
works for all keyboards. 

Translation 

Enter a phrase in one alphabet and localized BASIC translates 
and and displays it in a different alphabet. Different versions of 
localized BASIC support different input methods and hardware. 

Programmatic 

Generate characters using BASIC string functions. These methods 
work for one- or two-byte characters. 


Using Any Char 

Note that Any Char can be used from any keyboard to generate either one- or 
two-byte characters byte by byte . Thus, two codes must be specified to generate 
a single two-byte character. 

The appearance of a two-byte character typed into a quoted string on the 
command line may be somewhat confusing. Type in the following statement 
on the BASIC command line. Observe the difference between the printed 
character and the contents of the quoted string on the command line. 
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PRINT " Any Char 130 Any Char 096" ( Return 1 


If you have the Japanese localization binaries loaded, this will print the 
two-byte letter A on the screen. 

Special Key Assignments 

Some localized versions of BASIC assign special functions to various key 
combinations. These keys are frequently in conjunction with keyboard input 
translators. For example, Japanese localized BASIC defines actions for many 
control key sequences, such as [ctrlH TI (CTRLMn^ , and others. You need to 
be aware of these types of key definitions if you write a program with its own 
keyboard handler. 

Keyboard STATUS and CONTROL Registers 

Globalized BASIC contains the additional keyboard STATUS/CONTROL 
registers 24 and 25. These registers affect two-byte character input 
and are inoperative unless an INPUT binary is loaded. Refer to the 
CONTROL/STATUS register summary in the BASIC Language Reference for 
details. 

Some versions of localized BASIC include additional keyboard 
STATUS/CONTROL registers. For details, refer to the manual Using 
LanguageX with HP BASIC where LanguageX is your local language. 
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Using Displays 

This section explains how to display two-byte characters using globalized 

BASIC. 

Hardware Support 

The CRTD binary used to display all two-byte characters works only with HP 
Series 300 bit-mapped computer displays. CRTD does not support HP Series 
200 displays, so you cannot display two-byte characters on an HP Series 200 
computer. Similarly, CRTD does not the HP 98546 Display Compatibility 
Interface for HP Series 300 computers, or the HP 98700 Graphics Display 
Station. 

Overview of Fonts 

A font describes the way a printable character is displayed on the BASIC 
screen. BASIC uses raster fonts in its alpha display and graphics fonts in its 
graphics display. A raster font defines each displayed character as a matrix of 
pixels. A graphics font defines each displayed character as an outline traced by 
a graphics pen. 

PRINT "HELLO" raster font 

LABEL "HELLO" graphics font 

Note that raster fonts vary among different displays. This is because pixels 
in displays vary widely in their number, size and shape. In particular, you 
cannot assume that two arbitrary displays contain the same number of rows 
or columns of characters. To determine the physical characteristics of your 
display, use SYSTEM$(“CRT ID”), CHRX, CHRY, and ALPHA HEIGHT. 
Refer to the “Displays” chapter of HP BASIC Programming Techniques, 
Volume 2: Specific Interfaces for details. 

Two-Byte Fonts 

Ordinarily, BASIC uses the standard one-byte Extended ASCII or Japanese 
Katakana characters for graphics and raster fonts. To be able to process and 
display two-byte characters, you generally must load the following binaries: 

■ CRTD—Supports display of raster characters on the display. 
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■ FONT—Contains raster font FONT definitions. 

■ LANGUAGE—Contains graphics FONT definitions. 

■ GRAPH—Supports the LABEL command. 


Two-Byte Font 

Binaries Required 

Raster Font 

LANGUAGE 

FONT 

CRTD 

Graphics Font 

LANGUAGE 

FONT 

CRTD 

GRAPH 


In addition to loading these binaries into memory, you may also need to 
activate the CRTD binary, depending on what other display drivers you have 
loaded (CRTA,CRTB). To do this, use one of the following two statements: 

CONTROL CRT,21;4 activate CRTD, single-width characters 
CONTROL CRT,21;5 activate CRTD, double-width characters 

Globalized BASIC supports the simultaneous display of one- and two-byte 
characters. For example, you can display a line of text containing one-byte 
Roman characters and two-byte Japanese characters. 

Look-alike Characters 

Note that LANGUAGE and FONT usually contain two-byte characters 
corresponding to Roman letters and digits. It is very important to distinguish 
between one-byte characters and their two-byte character look-alikes. Certain 
functions in BASIC require one-byte characters. Other functions behave 
differently depending on character length. For example, the Japanese FONT 
definition contains these codes for the Roman letter A: 

One_byte$=CHR$ (65) one-byte Roman letter A 

Two_byte$=CHR$(130)ftCHR$(96) two-byte Roman letter A (HP-15 Japanese) 
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Character Size 


Two-byte characters are displayed twice as wide as one-byte characters. 

This must be done to clearly depict complex Asian language characters. 
Consequently, the two-byte Roman letter A is twice as wide as the one-byte 
Roman letter A. One-byte characters are the same height as two-byte 
characters. These rules apply to both raster and graphics fonts. 

Double and Single Width. When CRTD, FONT and LANGUAGE are loaded 
and CRTD is activated, you can set the size of raster characters to double or 
single width. Raster character height is unaffected. Double-width characters 
are intended for use primarily with 12-inch displays, although you can use them 
on any display. Most two-byte raster characters are not readable on 12-inch 
displays unless they are displayed using double width. 

Galley Characters 

Sometimes BASIC cannot display a character that you request. If you try to 
display a valid HP-15 character that has no font description, BASIC displays a 
galley character in place of the character you requested. A galley character is a 
blank or empty character of the same dimensions as a printable character. 


A 

• • 

•_* 

1 —Normal 1 

A 



Using PRINT (raster font) 


t 


c 


Using LABEL (graphics font) 


two—byte galley character (blank) 
Normal two—byte character 
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Determining Display and Character Size 

If your program must support different languages or different displays, you 
may need to determine character and display sizes. You can determine raster 
character size in pixels using CHRX and CHRY. Note that the values returned 
by CHRX and CHRY apply to one-byte raster characters. 

You can use CSIZE to set the size and aspect ratio of graphics fonts (graphics 
characters), but two-byte characters are always twice and as wide and the same 
height as one-byte characters. 

CRT STATUS registers 9 and 13 contain the width and height of the print area 
respectively. The following code segment determines the size of the display area 
in character units (current one-byte characters): 

100 ! X_size = Screen width in one-byte characters 

110 ! Y.size = Screen height in one-byte characters 

120 ! 

130 STATUS CRT,9;X_size 
140 STATUS CRT,13;Y_size 

Using the Print Area 

Globalized BASIC allows you to intermix one- and two-byte characters on the 
same line of the print area of the display. The print area is the set of lines at 
the top of the CRT used by the PRINT command. The ability to mix one- and 
two-byte characters creates some unique situations when overwriting characters 
with TABXY. 

In the following discussion and examples, lower case letters represent one-byte 
characters and upper case letters represent two-byte characters. Thus, the 
following program segment contains a sequence of alternating one- and 
two-byte characters: 

10 CLEAR SCREEN 

20 PRINT "AaBbCc" a=l-byte, A=2-byte 

It is important to distinguish the physical positions of the characters on the 
screen from their position in memory. In the preceding example there are six 
characters totalling 9 bytes. When addressing a position in the print area with 
TABXY, localized BASIC determines position on a byte-by-byte basis, not a 
character-by-character basis. Since Extended ASCII and Japanese Katakana 
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characters are always one-byte per character, this is consistent with previous 
versions of BASIC. 


TABXY Positions 


Character 

Bytes 

TABXY 

Position 

A 

2 

1 

a 

1 

3 

B 

2 

4 

b 

1 

6 

C 

2 

7 

c 

1 

9 

Total 

9 



Suppose you want to overwrite a character using the secondary keyword 
TABXY. We can easily expand the previous example to do this: 


10 

CLEAR SCREEN 


20 

PRINT M AaBbCc M 

a=l-byte, A = 2-byte 

30 

PRINT TABXY(1,1), M Z M 

replace 2-byte A with 2-byte Z 

10 

CLEAR SCREEN 


20 

PRINT M AaBbCc M 

a=l-byte, A = 2-byte 

30 

PRINT TABXY(3,1)> M z H 

replace 1-byte a with 1-byte z 


These operations are simple if you replace one-byte characters with one-byte 
characters, and two-byte characters with two-byte characters. In each case, the 
new character fills the same amount of space as the old character. But what 
happens if you try to overwrite a one-byte character with a two-byte character, 
or vice versa? What happens if you try to overwrite the second byte of a 
two-byte character? The figures that follow illustrate what happens in a variety 
of cases. 
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□ - 


= Any one-byte character 

One-byte space character 


E 


first byte 


Tt 


= Any two-byte character 
second byte 


Overwriting With One-Byte Characters 
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New 

Old 

Case 1 

Case 2 

Case 3 



* 

> 


t 


Result 

Ai 


—H-1— 

A 

— H — i— 



— i-1— 

A 




= One-byte space character (Blank) 


first 


byte 


—I— 

bn. 


= Any two-byte character 
second byte 


Overwriting With Two-Byte Characters 


The following general rules apply when overwriting print area characters with 
PRINT TABXY: 

■ Unused portions of the print area are filled with one-byte spaces. CLEAR 
SCREEN fills the entire print area with one-byte spaces. 

■ There are always the same number of bytes on a line after a TABXY 
overwrite as before it. Output formatted in columns remains intact. 

■ Any unused portion of an overwritten two-byte character is replaced by a 
one-byte space character. 


Display Enhancement Characters 

BASIC uses certain characters as display enhancement characters. These 
characters do not occupy any space on the screen, nor do they produce 
any immediately visible effect. Display enhancement characters change the 
appearance of characters that follow. 
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Globalized BASIC defines both one- and two-byte display enhancement 
characters. The one-byte display enhancement characters are the same 
as those used in BASIC/WS/UX 5.x and previous versions; they are 
CHR$(128)-CHR$(143). The two-byte display enhancement characters are 
created by adding CHR$(255) before the one-byte display enhancement 
character. For example: 

PRINT CHR$ (132) ; A$; CHR$ (128) underline on/off 

PRINT CHR$ (255)&CHR$(132) ; A$; CHR$ (255)ftCHR$(128) underline on/off 


Monochrome Display Enhancements 


Character 

Resulting Enhancement 

One-byte 

Two-byte 


CHR$(128) 

CHR$(255)&CHR$(128) 

All enhancements off 

CHR$(129) 

CHR$(255)&CHR$(129) 

Inverse video on 

CHR$(130) 

CHR$(255)&CHR$(130) 

Blinking on 

CHR$(131) 

CHR$(255)&CHR$(131) 

Inverse video and blinking on 

CHR$(132) 

CHR$(255)&CHR$(132) 

Underline on 

CHR$(133) 

CHR$(255)&CHR$(133) 

Underline and inverse video on 

CHR$(134) 

CHR$(255)&CHR$(134) 

Underline and blinking on 

CHR$(135) 

CHR$(255)ftCHR$(135) 

Underline, inverse video, and blinking on 
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Color Display Enhancements 


Character 

Resulting Enhancement 

One-byte 

Two-byte 

Model 236C 

Bit-mapped 

CHR$(136) 

CHR$(255)JtCHR$(136) 

White 

Pen 1 

CHR$(137) 

CHR$(255)&CHR$(137) 

Red 

Pen 2 

CHR$(138) 

CHR$(255)&CHR$(138) 

Yellow 

Pen 3 

CHR$(139) 

CHR$(255)&CHR$(139) 

Green 

Pen 4 

CHR$(140) 

CHR$(255)ftCHR$(140) 

Cyan 

Pen 5 

CHR$(141) 

CHR$(255)&CHR$(141) 

Blue 

Pen 6 

CHR$(142) 

CHR$(255)&CHR$(142) 

Magenta 

Pen 7 

CHR$(143) 

CHR$(255)&CHR$(143) 

Black 

Pen 8 


Display Enhancement Guidelines 

For maximum portability between localized and non-localized BASIC, 
always use the two-byte form of display enhancement characters. Two-byte 
display enhancements are compatible with both one- and two-byte languages. 
One-byte display enhancement characters are not compatible with many 
two-byte languages. 

If you have difficulty debugging a problem, you may want to use DISPLAY 
FUNCTIONS ON/OFF to inspect display enhancements on the screen. See the 
DISPLAY FUNCTIONS ON/OFF entry in the HP BASIC Language Reference 
for more details. 

The Two-Byte Underline Character 

When you specify underlining for displayed characters, BASIC creates the 
underlined image by combining the bits of the character to be underlined with 
a predefined underline character. More specifically, the bit patterns that define 
the character image and the underline image are exclusively OR’d to form 
the final image of the underlined character. The one-byte underline image is 
CHR$(256). The two-byte underline images are defined by CHR$(257) and 
CHR$(258). 
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You can alter the pre-defined pattern stored in any of the underline characters 
using SET CHR. Refer to the SET CHR entry in the HP BASIC Language 
Reference for details. 


Using Printers 

Globalized BASIC supports both one-byte and two-byte printers. The 
secondary keywords EXCHANGE and SHIFT IN ... OUT can be used with 
ASSIGN, PRINTER IS, PRINTALL IS, and DUMP DEVICE IS to properly 
configure BASIC to communicate with two-byte printers. Once it is properly 
configured, BASIC will automatically send mixtures of one- and two-byte 
characters to the printer using the proper format and protocol for each. 

Using EXCHANGE 

Globalized BASIC uses HP-15 to represent any two-byte characters that are 
stored internally. Therefore, all characters displayed on the screen, including 
both raster and graphics fonts, are HP-15. Since some two-byte printers use 
HP-16 or other character codes to print two-byte characters, localized BASIC 
provides a way to convert between the two using EXCHANGE. 
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Character Conversion Using EXCHANGE 

Note When the LANGUAGE binary is loaded, the DUMP DEVICE 

IS device defaults to HP-16 conversion. 


Using SHIFT IN ... OUT 

Some two-byte printers can shift back and forth between printing one- and 
two-byte characters. You must send special escape codes to tell the printer 
whether the bytes that follow are to be interpreted as one- or two-byte 
characters. 
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Two-Byte Printer Example 

Suppose you wish to use the HP C1202A Asian Highspeed Serial Printer as the 
PRINTER IS device. The following code segment shows how you might use 
EXCHANGE and SHIFT IN ... OUT to print Japanese one- and two-byte 
characters: 

100 In$=CHR$(27)ft"$2«" 

110 0ut$=CHR$(27)fc"(2C" 

120 ! 

130 PRINTER IS 701;EXCHANGE "HP-16" SHIFT IN In$ OUT 0ut$ 

The EXCHANGE "HP- 16" part of line 130 automatically converts characters from 
the HP-15 format used in BASIC memory to HP-16 for printing. The SHIFT 
IN In$ part of line 130 causes BASIC to automatically send the proper escape 
string to the printer before printing two-byte characters. Similarly, OUT 0ut$ 
causes BASIC to automatically send the proper escape string to the printer 
before printing one-byte characters. 

You can use similar methods with the other printer related commands. For 
example: 

ASSIGN •Asian.prt TO 701; EXCHANGE "HP-16" SHIFT IN In$ OUT 0ut$ 

DUMP DEVICE IS 701; EXCHANGE "HP-16" SHIFT IN In$ OUT 0ut$ 

PRINTALL IS 701; EXCHANGE "HP-16" SHIFT IN In$ OUT 0ut$ 

For more details on using printers, refer to Using LanguageX with HP BASIC, 
where LanguageX is your local language. 


New Keywords 

Globalized BASIC includes a number of new and enhanced keywords designed 
to handle two-byte characters and localization files. This section briefly 
describes how to use the new commands. For additional details and syntax 
diagrams, refer to the HP BASIC Language Reference. 
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Summary of Globalization/Localization Keywords 


Keyword 

Type 

Description 

CVT$ 

function 

Converts strings from one alphabet to another, 
character by character. 

FBYTE 

function 

Returns 1 (true) if the first byte of the string 
argument is a valid first byte of a two-byte (HP-15) 
character. 

SBYTE 

function 

Returns 1 (true) if the first byte of the string 
argument is a valid second byte of a two-byte (HP-15) 
character. 

GFONT IS 

statement 

Specifies the file which contains graphics font data. 

DICTIONARY IS 

statement 

Specifies the dictionary file used for translating 
phrases. 

EXCHANGE 

secondary 

Used with printer related commands to convert 
internally stored HP-15 characters codes to printer 
compatible codes. 

SHIFT IN/OUT 

secondary 

Used with printer related commands to specify what 
control strings set the printer one-byte/two-byte mode. 


Using CVT$ 

Some two-byte languages, such as Japanese, use several alphabets. Therefore, 
it is often desirable to translate from one alphabet to another. The 
CVT$ function allows you to perform this translation inside a localized 
BASIC program. Note that CVT$ converts strings character by character . 
Consequently, localized BASIC will convert strings containing a mixture of 
both one- and two-byte characters. 

To access CVT$, you must load a localized LANGUAGE binary. LANGUAGE 
determines the choices that are available for source and destination alphabets. 
LANGUAGE also determines the character mapping between alphabets. 
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Here are some CVT$ examples using the Japanese LANGUAGE binary: 

New$=CVT$(01d$,"ZENKAKU KATAKANA TO ZENKAKU HIRAGANA") 

New$=CVT$(01d$,"HANKAKU KATAKANA TO HANKAKU HIRAGANA") 


Using FBTYE and SBYTE 

The functions FBYTE and SBYTE are generally used together to determine 
whether a particular character is one or two bytes long. FBYTE returns 1 
(true) when the first byte of the string argument is in the valid range for the 
first byte of two-byte HP-15 characters. SBYTE returns 1 (true) when the 
first byte of the string argument is in the valid range for the second byte of 
two-byte HP-15 characters. 

Note that both FBYTE and SBYTE operate on the first byte of their string 
argument. You must use substring expressions to properly test the first byte 
with FBYTE and and the second with SBYTE. 

The following program illustrates a practical application of FBYTE and 
SBYTE. 

100 ! This program analyzes the byte length of each character in a string 

110 DIM A$[64] 

120 INTEGER L,I 

130 LINPUT "Type in a string ... ",A$ 

140 L=LEN(A$) 

150 1=1 

160 WHILE I<=L 

170 IF FBYTE(A$[I]) AND I<L THEN ! It may be a valid two-byte character 
180 IF SBYTE(A$[1+1]) THEN ! It is a valid two-byte character 

190 PRINT M,,, ;A$[I;2] 2-byte character" 

200 1 = 1+2 

210 ELSE ! Invalid 2nd byte;treat them as 2 ASCII characters 

220 PRINT " *"; A$ [I; 1] ;" *, ’"; A$[1+1;1];" , : Two 1-byte characters" 

230 1=1+2 

240 END IF 

250 ELSE 

260 PRINT M, ";A$[I;1]: 1-byte character" 

270 1=1+1 

280 END IF 

290 END WHILE 
300 END 
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Using GFONT IS 

Localized BASIC uses a special graphics font to display graphics characters. 
You must specify the file that supports the graphics font using GFONT IS 
before using LABEL to display a character. For example: 

GFONT IS "/users/BASIC/JPN_VECTOR" 

GFONT IS ”JPN_VECTOR:,700,0" 

You can check the current setting of GFONT IS using SYSTEMS. For 
example: 

01d_gfont$=SYSTEM$("GFONT IS") 

Using DICTIONARY IS 

Some versions of localized BASIC support automatic input phrase translators. 
The user types a phrase into a conversion buffer and presses a special key 
to invoke the translator. The translator converts strings word by word, not 
character by character as CVTS does. The translation information is contained 
in a dictionary file. This file must be specified using the DICTIONARY IS 
command before attempting translation. For example: 

DICTIONARY IS "JPN.SYSDCT:,700,0","SYSTEM" 

DICTIONARY IS "/users/BASIC/JPN_USRDCT","USER" 

The second string parameter is used by some versions of localized BASIC 
to specify additional dictionaries. For example, Japanese localized BASIC 
supports a standard dictionary (SYSTEM) and a user-defined dictionary 
(USER). 

You can check the current settings of DICTIONARY IS and the contents of the 
conversion buffer using SYSTEMS. For example: 

01d_sysdct$=SYSTEM$("DICTIONARY IS:SYSTEM") 

01d_ursdct$=SYSTEM$("DICTIONARY IS:USER") 

Convert$=SYSTEMS("CONVERSION BUFFER") 

Note that you can programmatically translate phrases by sending the 
appropriate simulated keystrokes to the keyboard buffer using OUTPUT KBD. 
Refer to the “Keyboards” chapter of HP BASIC Interfacing Techniques, 

Volume 2: Specific Interfaces for information on simulating keystrokes. 
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Using EXCHANGE and SHIFT IN ... OUT 

Localized BASIC stores all two-byte strings internally as HP-15 codes. Many 
printers use character codes other than HP-15. The secondary keyword 
EXCHANGE allows you to automatically convert HP-15 characters to an 
alternate character set, such as HP-16 or the Japanese Industrial Standard 
(JIS). 

The LANGUAGE binary determines the choices available for alternate 
character sets. You must load a LANGUAGE binary to use EXCHANGE or 
SHIFT IN/OUT. 

The keywords that support EXCHANGE and SHIFT IN/OUT are: 

ASSIGN 

DUMP DEVICE IS 
PRINTALL IS 
PRINTER IS 

Refer to the previous section “Using Printers” for more details. 
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Changes in String Functions 

Certain string related functions in BASIC behave differently when handling 
one-byte characters and two-byte characters. Globalized BASIC does not 
change any of the previously existing definitions for one-byte characters—it is 
backward compatible. However, two-byte characters must sometimes be treated 


specially. 

Function 

Comments 

& 

Concatenates two strings. The strings may contain any 
combination of one- and two-byte characters. 

CHR$ 

Converts a numeric value to one byte of a character. Two-byte 
characters must be constructed byte by byte. For example, 
the two-byte Roman letter A is CHR$(130)&CHR$(96) (using 
(HP-15) Japanese). 

DVAL 

Converts strings representing hexadecimal, octal, and binary 
numbers into numeric values. The string digits must be 
one-byte characters. 

DVAL$ 

Converts numeric values to into strings representing 
hexadecimal, octal, or binary numbers. The digits in the 
resulting string are one-byte characters. 

IVAL 

Converts strings representing hexadecimal, octal, and binary 
numbers into INTEGER values. The string digits must be 
one-byte characters. 

IVALS 

Converts INTEGER values to into strings representing 
hexadecimal, octal, or binary numbers. The digits in the 
resulting string are one-byte characters. 

LEN 

Returns the number of bytes in a string. The string may 
contain any combination of one- and two-byte characters. 

LEXICAL 
ORDER IS 

Determines the collating sequence used in string comparisons. 
Valid only for one-byte characters. 

LWC$ 

Returns the lower case value of a string. Only one-byte 
characters are converted to lower case; two-byte characters are 
returned unchanged. 
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MAXLEN 


Returns the maximum (dimensioned) length of a string in 
bytes. 

NUM Returns the decimal value of the first byte of a string. The 

string may contain any combination of one- and two-byte 
characters. You must use substrings to identify each byte of a 
two-byte character. 

POS Returns the byte position of a substring within a string. Either 

string may contain any combination of one- and two-byte 
characters. 

REVS Reverses the order of the characters in a string expression. 

The operation is performed character by character on any 
combination of one- and two-byte characters. 


RPTS Repeats the characters in a string a specified number of times. 

The repeated string may contain any combination of one- and 
two-byte characters. 


TRIMS 

Removes leading and trailing one-byte blanks from a string. 

The string may contain any combination of one- and two-byte 
characters. Only CHR$(32) (ASCII space) is trimmed from the 
string. 

UPCS 

Returns the upper case value of a string. Only one-byte 
characters are converted to upper case; two-byte characters are 
returned unchanged. 

VAL 

Converts a string representing a decimal number into a 
numeric value. The string digits must be one-byte numeric 
characters. 

VALS 

Converts a numeric value into a string representing a decimal 
number. The string contains only one-byte numeric characters. 


String Comparisons 

BASIC can compare strings containing combinations of one- and two-byte 
characters using the comparison operators. BASIC compares characters byte 
by byte, without regard to two-byte character boundaries. Note that BASIC 
does not support LEXICAL ORDER for two-byte characters. 
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In general, the combined character order is: 

(ASCII characters)<(two-byte characters) 

Some versions of localized BASIC use a slightly modified combined character 
order to accomodate local custom. Refer to Using LanguageX with HP BASIC 
for details, where LanguageX is a local language, such as Japanese. 


Porting and Globalization 

This section describes how to move BASIC programs between different versions 
of BASIC. Specifically, this section describes how using two-byte characters 
affects portability. 


Understanding Porting and Localization 

To accurately discuss portability, we must first define porting and portability in 
the context of localized BASIC. There are different cases to consider: 


Application Type 

Globalized Application 


Localized Application 


Description 

A BASIC program designed to run on a variety of 
different localized BASIC systems. In the general 
case, one or more local languages may use one-byte 
characters and one or more may use two-byte 
characters. Writing globalized applications is 
relatively complex; only general guidelines are 
presented here. 

A single BASIC program designed to work with 
only one specific localized version of BASIC. This 
is the most common case. This section describes 
common problems when porting from one-byte 
BASIC to localized two-byte BASIC. 
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Globalization Portability Guidelines 


Code 

Guideline 

A 

Use two-byte display enhancement characters and eliminate one-byte display 
enhancement characters. Refer to the preceding section “Display Enhancement 
Characters.” 

B 

Avoid using two-byte characters, except when they are visible to the operator. 

For example, do not use two-byte labels or variable names. 

c 

Use one-byte characters for file names and eliminate two-byte characters. Avoid 
special characters; use letters, numbers, and the underscore character. 

D 

Determine the number of rows and columns on the display inside your program. 

In particular, note that two-byte characters are twice as wide as one-byte 
characters. Refer to the preceding sections “Character Size” and “Determining 
Display Size” for more information. 

E 

Avoid changing strings once they are input or defined. You must use FBTYE 
and SBYTE to determine the byte length of each character in a string if it 
contains a mixture of one- and two-byte characters. For more information on 
FBYTE and SBYTE, refer to the preceding section “New Keywords” and the 

HP BASIC Language Reference. 

F 

Use only one-byte characters as punctuation characters in BASIC statements 
and as data separators. For example, commas, semicolons, and quotes must be 
one-byte characters. 

G 

If you use two-byte characters in your program, you must load the proper 

CRTD, LANGUAGE, FONT, and INPUT binaries. Certain keywords and 
CONTROL/STATUS registers are not recognized until these binaries are loaded. 
Refer to the appropriate keyword or register entries in the HP BASIC Language 
Reference. 

H 

Use string functions with two-byte characters very carefully. Some string 
functions do not allow two-byte characters or ignore them. Other string 
functions treat two-byte characters byte by byte instead of character by 
character. Refer to the previous section “Changes in String Functions” for 
details. 

I 

Use only one-byte characters for numeric input. Use one-byte numeric 
characters, decimal points, plus and minus signs, and E. 

J 

Store message text containing two-byte characters in language specific 
subprograms or text files. 


26-28 Features of Globalized BASIC 





















Special Cases 

It is important to note that if a program runs properly on a non-localized 
BASIC system, it will run on an equivalent localized BASIC system with very 
little modification. The only change required is the use of two-byte display 
enhancements characters. The localized and non-localized systems must be of a 
compatible BASIC software revision. 

Conversely, a program that runs on a localized BASIC system and uses 
two-byte characters generally will not run on a non-localized system. 


Easily 

Ported 


Easily 

Ported 



Often 

Not 

Portable 
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Index 


A 

Accessing Files Created on Non-Series- 
200/300 SRM Workstations, 21-30 
Alpha and Graphics Planes, Configuring 
Separate, 19-25 
Alpha Color Changes, 19-35 
ALPHA OFF statement, 22-4 
ALPHA ON statement, 22-4 
Alpha Screen Height and Graphics Scrolling, 
19-35 

APPEND, 24-10 
ASCII File Access, 21-19 
ASSIGN statement, 21-7, 22-4 
Automatic Display Selection at System 
Boot, 19-31 

B 

BASIC 4.0 Enhancementsfor Series 200 
Computers, 19-38 
BASIC/DOS, 22-1 
BASIC/UX, 22-1 
BASIC/UX Differences, 22-3 
BASIC/UX enhancements, 22-20 
BASIC/UX environment, entering and 
exiting, 22-21 

BASIC/UX mass storage differences, 22- 
18 

BASIC/UX mass storage enhancements, 
22-29 

BASIC/WS, 22-1 

Battery-Backed Real-Time Clock, 19-7 
Binary Files, HP-UX Text and, 21-6 


Binary Integers (HP-UX File Access), 21- 
15 

Binary Real Values (HP-UX File Access), 
21-12 

Binary Strings (HP-UX File Access), 21- 
17 

BIN Files, Missing Driver, 18-4 

BNC Video Connectors, The Relay and, 

19- 28 

Built-In Interfaces, 19-7 
Burst mode of I/O, 22-25 

C 

CALL, 24-13 

Case of I/O Transfers, Special, 18-23 
Categories of New Features (BASIC 5.0), 

20 - 2 

CAT statement, 22-4 
Centronics interface, 24-2 
Changes, Statement, 18-4 
Character Codes 
HP-15 and HP-16, 25-6 
Character Conversions, 25-10 
Characters 
Size, 26-12 

Character Width, 26-11 

CHRX, 26-12 

CHRY, 26-12 

CLEAR WINDOW statement, 22-24 
Color Changes, Hidden, 19-37 
Common Data Types, 21-5 
Common File Types, 21-4 
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Compatibility, GLOAD/GSTORE, 19-35 
Compatibility Interface Capabilities, Dis¬ 
play, 19-29 

Compatibility Interface, Using the Dis¬ 
play, 19-26 

Compatibility Mode, 19-18 
Compatibility Mode, Enabling Keyboard 
(KBD CMODE ON), 19-17 
Compatibility Mode, Exiting Keyboard 
(KBD CMODE OFF), 19-24 
Compatibility Mode, HP 98203 Key¬ 
board, 19-13 

Compatibility with Preceding Versions, 
18-2 

Compatibility with Previous Revisions 
(BASIC 6.0), 24-1 

Compatibility with Previous Versions (BA¬ 
SIC 5.0), 20-1 

Composition of SRM File Names, 21-26 
Configuration Program, Using a, 19-12 
Configurations Possible, 19-29 
Configuring BASIC, 18-2 
Configuring Separate Alpha and Graphics 
Planes, 19-25 

Copying files from a LIF disk, 23-2 
Copying files from a mounted HFS file 
system, 23-3 

Copying files from an SRM disk, 23-3 
Copying Item-by-Item Using ENTER and 
OUTPUT, 21-29 
CREATE statement, 21-6, 22-5 
CREATE WINDOW statement, 22-24 
CRTD, 24-12 
CRTD binary, 26-9 
CSIZE, 26-12 

CSUB Capabilities (BASIC 5.0), Addi¬ 
tional, 20-14 
CSUBs, 18-5, 24-11 
CSUBs, Incompatible, 19-34 
CSUB Utility, 20-15 
CVT$, 26-21 


D 

Data, Textual Numeric, 21-7 
Data-Type Matching Between BASIC 
and C, 21-6 

Data Types, Common, 21-5 
Default Plotter, 18-11 
Description of Series 300 Hardware, 19-3 
DESTORY WINDOW statement, 22-24 
Device Viewport, Input, 18-12 
DICTIONARY IS, 26-23 
Directory Paths, Allowing for SRM, 21-27 
DISABLE EXT SIGNAL statement, 22- 
27 

Display Compatibility Interface Capabil¬ 
ities, 19-29 

Display Compatibility Interface, Using 
the, 19-26 

Display Drivers, Removing, 19-32 
Display Enhancement Characters, 26-15 
Display Functions, 18-22 
Displays, 19-4 

Using With Two-Byte Characters, 26-9 
Display Selection at System Boot, Auto¬ 
matic, 19-31 
Documentation, 18-2 
Driver BIN Files, Missing, 18-4 
DUMP ALPHA statement, 22-6 
DUMP DEVICE IS statement, 22-6 
DUMP GRAPHICS statement, 22-6 

E 

ENABLE EXT SIGNAL statement, 22- 
27 

Enabling Keyboard Compatibility Mode, 
19-17 

Enhancements, 5.1, 20-14 
ENTER statement, 22-7 
ERRM$ statement, 22-7 
ERRN statement, 22-7 
EXCHANGE, 25-11, 26-18, 26-24 
EXECUTE statement, 22-23 
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Exiting Keyboard Compatibility Mode, 
19-24 

Extend Keys, 26-3 

F 

FBYTE, 26-22 
File Access, ASCII, 21-19 
File Dump Utility, HP-UX, 21-23 
Files Created on Non-Series-200/300 SRM 
Workstations, Accessing, 21-30 
File Specifiers, SRM, 21-26 
File Types, Common, 21-4 
Fonts, 26-9 

Function, KNOBX, 18-6 

G 

Galley Characters, 25-9, 26-11 
GCLEAR, Implicit, 18-12 
GESCAPE statement, 22-7, 22-28 
GET, 24-10 
GFONT, 26-23 

GLOAD/GSTORE Compatibility, 19-35 
GLOAD statement, 22-7 
Globalization 

BASIC Architecture, 25-13 
BASIC Features, 26-1 
BASIC Support, 25-1 
Definition, 25-3 
Overview, 25-1 

Summary of BASIC Features, 25-13 
Graphics buffering, 22-28 
Graphics Features (BASIC 5.0), Addi¬ 
tional, 20-13 
Graphics Fonts, 26-9 
GRAPHICS INPUT IS statement, 22-7 
GRAPHICS OFF statement, 22-8 
GRAPHICS ON statement, 22-8 
Graphics Planes, Configuring Separate 
Alpha and, 19-25 

Graphics Scrolling, Alpha Screen Height 
and, 19-35 


Graphics Tablet DIGITIZE, 18-12 
GSTORE statement, 22-8 

H 

Hardware Description, 19-28 
Hardware, Description of Series 300 Hard¬ 
ware, 19-3 

Hardware Support (BASIC 6.0), 24-2 
Hardware Supported (BASIC 5.0), New, 
20-3 

Helpful Documentation, 18-2 
HFS binary, 24-12 

HFS Discs and Data Files, Sharing, 21-2 
HFS Disc Support, 20-5 
HFS file buffering, 22-27 
HFS files, locking, 22-29 
HFS files, maximum number of open, 22- 
18 

HFS file system, copying files from a 
mounted, 23-3 
HFS formatted discs, 22-8 
Hidden Color Changes, 19-37 
Hierarchical File System (HFS), 20-5 
HIL “System” Menu Labels, 19-16 
HIL “Typing-Aid” Softkey Labels, 19-16 
HP-15, 25-6, 25-11, 26-18 
HP-16, 25-6, 25-11, 26-18 
HP 3630A (PaintJet™), 20-15 
HP 98203 Keyboard Compatibility Mode, 
19-13 

HP 98203 Softkey Labels, 19-15 
HP 98203 Specific Key Codes, 19-34 
HP 98548A, 20-15 
HP 98549A, 20-15 
HP 98550A, 20-15 

HP 98644 Serial Interface Configuration, 
19-12 

HP 98646A VME Interface, 20-15 
HP-HIL devices, selecting, 22-26 
HP-HIL Keyboard Interface, 19-8 
HP-HIL Keyboards with Mouse, 18-9 
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HP-HIL Knob Interval Parameter, 19-37 
HP-HIL Support (BASIC 5.0), Addi¬ 
tional, 20-12 

HP-UX Binary Files, 21-6 
HP-UX File Dump Utility, 21-23 
HP-UX File Terminology, A Note About, 
21-2 

HP-UX pipes, using, 22-25 
HP-UX signals, trapping, 22-27 
HP-UX Text and Binary Files, 21-6 
HP-UX Text Files, 21-6, 21-8 
Human Interface Enhancements (BASIC 
5.0), 20-6 

I 

ID PROM, 19-10 
Implicit GCLEAR, 18-12 
Incompatible CSUBs, 19-34 
INITIALIZE statement, 22-9 
INMEM, 24-13 
Input Device Viewport, 18-12 
Interface Capabilities, Display Compati¬ 
bility, 19-29 

Interface Configuration, HP 98644 Serial, 
19-12 

Interface Enhancements (BASIC 5.0), 
Human, 20-6 

Interface, HP-HIL Keyboard, 19-8 
Interface mapping, 22-25 
Interfaces, Built-In, 19-7 
Interface, Serial, 19-7 
I/O Transfers, Special Case of, 18-23 
ITF keyboard, 19-15 

K 

Keyboard Compatibility Mode, Enabling, 
19-17 

Keyboard Compatibility Mode, Exiting, 
19-24 

Keyboard Compatibility Mode, HP 98203, 
19-13 


Keyboard Interface, HP-HIL, 19-8 
Keyboard Layouts, Brief Comparison of, 
19-13 
Keyboards 

Any Char Entry Method, 26-4 
Direct Entry Method, 26-2 
Extended Keyboard Entry Method, 26- 
3 

Non-ASCII Key Entry, 26-4 
Programmatic Entry Method, 26-5 
Special Keys, 26-8 
Use With Globalized BASIC, 26-1 
Keyboards with Built-in Knob, 18-8 
Key Codes, HP 98203 Specific, 19-34 
Keywords Duplicating Register Opera¬ 
tions, 20-8 

Keywords that Duplicate Register Oper¬ 
ations (BASIC 5.0), New, 20-8 
KNB2.0, 18-10 
Knob, 18-6 

Knob Interval Parameter, HP-HIL, 19-37 
Knob, Keyboards with Built-in, 18-8 
KNOBX function, 18-6 
KNOBX statement, 22-9 
KNOBY statement, 22-9 

L 

LABEL with PIVOT, 18-19 
Language Extensions BIN Files, Missing, 
18-3 

LIF disk, copying files from a, 23-2 
LIF Files to SRM, Porting, 21-25 
LIF media, accessing, 22-19 
LIF Protect Codes, SRM Passwords vs., 
21-28 

LINK command, 20-15 

Linked files, 20-16 

LIST BIN statement, 22-10 

LIST statement, 22-10 

LIST WINDOW statement, 22-24 

LOAD BIN statement, 22-10 


Index-4 





Loading and Running Programs, Just, 19- 

11 

Loading a program, 23-4 
Localization 
Definition, 25-3 
Locking an interface, 22-25 
Locking SRM files, 22-18 
LOCK statement, 22-29 
Long file names, 22-29 

M 

Mapping, interface, 22-25 
MASS STORAGE IS (MSI) statement, 
21-27 

Mass Storage Volume Specification, SRM, 

21- 27 

Mass storage volume specifier, 22-11 

Memory volume, 22-11 

Methods of Porting, 19-2 

Mode, Compatibility, 19-18 

Model 345, 24-2 

Model 375, 24-2 

Model V/360, 24-2 

Modifying the Source Program(Porting to 
4.0), 19-33 

MOVE WINDOW statement, 22-24 
MS BIN file, 18-2 
Multi-tasking capabilities, 22-22 
Multi-user capabilities, 22-22 

N 

Networked HFS file systems, accessing, 

22- 29 

Numeric Data, Textual, 21-7 

0 

OFF EXT SIGNAL statement, 22-27 
One-byte Characters 
Fonts, 26-9 
One-Byte Characters 
Definition, 25-4 


Detailed Discussion, 25-5 
Input Methods, 26-1 
ON EXT SIGNAL statement, 22-27 
ON KNOB “interval” parameter, 19-38 
ON/OFF CYCLE statement, 22-10 
ON/OFF DELAY statement, 22-10 
ON/OFF statement, 22-10 
ON/OFF TIME statement, 22-10 
OUTPUT statement, 22-10 
OVERWRITE, 24-10 

P 

PaintJet™ (HP 3630A), 20-15 
PASS CONTROL statement, 22-11 
PHYREC CSUB, 18-5 
PHYREC routine, 18-5 
Pipes, HP-UX using, 22-25 
PIVOT statement, 18-17 
Plotter, Default, 18-11 
PLOTTER IS Changes, 19-36 
PLOTTER IS statement, 22-12 
Porting 

Globalized BASIC, 26-27 
Porting and Sharing Files, 21-1 
Porting BASIC/WS programs to BA- 
SIC/UX, 23-1 

Porting Considerations, Additional, 19-34 

Porting LIF Files to SRM, 21-25 

Porting, Methods of, 19-2 

Porting to 3.0, 18-1 

Porting to 5.0, 20-1 

Porting to 6.0, 24-1 

Porting Topics Covered, 18-1 

Porting to Series 300 and 4.0, 19-1 

Prerun On LOADSUB, 18-23 

PRINTALL IS statement, 22-12 

PRINTER IS statement, 22-12 

Printers 

Printing Two-Byte Characters, 26-18 
PRINT LABEL statement, 22-12 
processor 
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MC68040, 24-2 
Processor Boards, 19-6 
Programming Additions (BASIC 5.0), 
General, 20-10 
PROTECT statement, 21-28 

R 

Raster Fonts, 26-9 
READ KEY, 24-11 
READ LABEL statement, 22-12 
Real-Time Clock, Battery-Backed, 19-7 
Relay and BNC Video Connectors, The, 
19-28 

RE-SAVE statement, 22-12 

RMBUX, 24-12 

RPLOT with PIVOT, 18-17 

Run light, 22-12 

RUNLIGHT ON/OFF, 24-11 

Running a program, 23-5 

Running Programs, Loading and, 19-11 

Run-time errors, correcting, 23-5 

Run-time errors, recognizing, 23-5 

S 

SAVE statement, 22-13 
SBYTE, 26-22 
SCRATCH, 24-13 
SCRATCH BIN statement, 22-13 
SCRATCH WINDOW statement, 22-24 
SCSI, 24-2 
SC statement, 22-13 
SELECT statement, 18-2 
SEPARATE ALPHA FROM GRAPH¬ 
ICS statement, 22-13 
Serial interface, 19-7 

Serial Interface Configuration, HP 98644, 
19-12 

Series 300 Display, Switching Back to the, 
19-30 

Series 300 Hardware, Description of, 19-3 
SET ALPHA MASK statement, 22-13 


SET DISPLAY MASK statement, 22-13 
SET HIL MASK statement, 22-26 
SET TIMEDATE statement, 22-14 
SET TIME statement, 22-14 
Sharing Files, Porting and, 21-1 
Sharing HFS Discs and Data Files, 21-2 
SHIFT IN ... OUT, 26-19, 26-24 
Silent errors, correcting, 23-6 
Silent errors, recognizing, 23-6 
Softkey Labels, HP 98203, 19-15 
Source Program(Porting to 4.0), Modify¬ 
ing the, 19-33 

SRM Directory Paths, Allowing for, 21-27 
SRM disk, copying files from an, 23-3 
SRM File Names, Composition of, 21-26 
SRM files, locking, 22-18 
SRM files open, leaving, 22-19 
SRM File Specifiers, 21-26 
SRM interface, 22-14 
SRM Mass Storage Volume Specification, 
21-27 

SRM Passwords vs. LIF Protect Codes, 
21-28 

SRM, Porting LIF Files to, 21-25 
SRM security, 22-19 

SRM Workstations, Accessing Files Cre¬ 
ated on Non-Series-200/300, 21-30 
Statement Changes, 18-4 
STATUS/CONTROL Registers (BASIC 
5.0), New, 20-11 

STORE SYSTEM statement, 22-15 
String Functions 
Two-Byte Characters, 26-25 
Strings, Textual, 21-10 
Switching Back to the Series 300 Display, 
19-30 

SYSBOOT statement, 22-15 
SYSTEMS, 24-13 

SYSTEM$(“AVAILABLE MEMORY”) state¬ 
ment, 22-15 
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SYSTEM$( “MASS MEMORY”) state¬ 
ment, 22-15 

SYSTEM$(“MASS STORAGE IS”) state¬ 
ment, 22-16 

SYSTEM$(“PROCESS ID”), 22-22 
SYSTEM$(“SERIAL NUMBER”) state¬ 
ment, 22-16 

SYSTEM$(“SYSTEM ID”) Values, New, 
19-35 

SYSTEM$( “VERSION:OS”), 22-22 
SYSTEM$(“WINDOW SYSTEM”), 22- 
22 

T 

Tablet DIGITIZE, Graphics, 18-12 
Textual Numeric Data, 21-7 
Textual Strings, 21-10 
TIMED ATE statement, 22-16 
TIMEZONE IS statement, 22-17 
TRANSFER statement, 22-17 
Two-byte Characters 

Converting Phrases, 25-12 
Fonts, 26-9 
Two-Byte Characters 

Character Conversions, 25-10 
Combining with One-byte, 25-5 
Converting Alphabets, 25-12 
Converting for Printing, 25-11 
Definition, 25-4 
Detailed Discussion, 25-6 


Determining Position, 26-13 
Galley Characters, 25-9, 26-11 
Hardware Support, 26-9 
Input Methods, 26-7 
Inserting and Overwriting, 26-13 
Keyboard STATUS and CONTROL, 
26-8 

Related BASIC Keywords, 26-20 
String Functions, 26-25 
Used in a Graphics Plot, 25-5 
Used in a Program, 25-4 
Using Displays With, 26-9 
Using Keyboards, 26-7 

U 

UNLOCK statement, 22-29 
Utilities (BASIC 5.0), New, 20-4 

V 

VIEWPORT statement, 18-12 
VME Interface (HP 98646A), 20-15 
Volume Specification, SRM Mass Storage, 
21-27 
VXI, 24-2 

W 

WAIT statement, 22-18 

wildcards, 24-9 

Window management, 22-23 
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